다음을 통해 공유


Microsoft C++ 도구 집합 또는 문서의 문제를 보고하는 방법

Microsoft C++ 컴파일러(MSVC), 링커 또는 기타 도구와 라이브러리에서 문제를 발견할 경우 알려주시기 바랍니다. 문서에 문제가 있는 경우에도 알려주세요.

C++ 도구 집합 문제를 보고하는 방법

문제를 알리는 가장 좋은 방법은 발견한 문제에 대한 설명이 포함된 보고서를 보내는 것입니다. 프로그램 빌드 방법에 대한 세부 정보를 모두 포함해야 합니다. 당사 머신에서 문제를 재현하는 데 사용할 수 있는 전체 테스트 사례인 재현도 포함되어야 합니다. 이 정보를 통해 로컬 환경이 아닌 코드에 문제가 있음을 빠르게 확인할 수 있습니다. 다른 버전의 컴파일러에 영향을 미치는지 여부를 확인하고 원인을 진단하는 데 도움이 됩니다.

다음 섹션에서는 좋은 보고서를 만드는 방법에 대해 알아봅니다. 발견한 문제 종류의 재현을 생성하는 방법 및 제품 팀에 보고서를 보내는 방법을 설명합니다. 보고서는 Microsoft와 다른 개발자에게 중요합니다. Microsoft C++ 개선에 도움 주셔서 감사합니다.

보고서를 준비하는 방법

완전한 정보가 없으면 발견한 문제를 재현하기 어렵기 때문에 고품질 보고서를 만드는 것이 중요합니다. 보고서가 향상될수록 더 효과적으로 문제를 재현하고 진단할 수 있습니다.

보고서에는 최소한 다음 정보가 포함되어야 합니다.

  • 사용 중인 도구 집합의 전체 버전 정보

  • 코드를 빌드하는 데 사용된 전체 cl.exe 명령줄

  • 발견한 문제에 대한 자세한 설명

  • 재현: 문제를 보여주는 완전하고 간소화된 자체 포함 소스 코드 예제입니다.

필요한 특정 정보와 해당 정보를 찾을 수 있는 위치 그리고 좋은 재현을 만드는 방법에 대해 자세히 읽어보세요.

도구 집합 버전

문제의 원인이 되는 도구 집합의 전체 버전 정보 및 대상 아키텍처가 필요합니다. 그러면 당사 머신에서 동일한 도구 집합으로 재현을 테스트할 수 있습니다. 문제를 재현할 수 있는 경우, 이 정보는 동일한 문제가 발생하는 다른 도구 집합 버전을 조사하는 시작점을 제공하기도 합니다.

컴파일러의 전체 버전을 보고하려면

  1. 프로젝트를 빌드하는 데 사용된 Visual Studio 버전 및 구성 아키텍처와 일치하는 개발자 명령 프롬프트를 엽니다. 예를 들어 x64 대상에 x64 Visual Studio 2017을 사용하여 빌드하는 경우 VS 2017용 x64 Native Tools 명령 프롬프트를 선택합니다. 자세한 내용은 개발자 명령 프롬프트 바로 가기를 참조하세요.

  2. 개발자 명령 프롬프트 콘솔 창에서 cl /Bv 명령을 입력합니다.

다음과 유사한 출력이 표시됩니다.

C:\Users\username\Source>cl /Bv
Microsoft (R) C/C++ Optimizing Compiler Version 19.14.26428.1 for x86
Copyright (C) Microsoft Corporation.  All rights reserved.

Compiler Passes:
 C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.14.26428\bin\HostX86\x86\cl.exe:        Version 19.14.26428.1
 C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.14.26428\bin\HostX86\x86\c1.dll:        Version 19.14.26428.1
 C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.14.26428\bin\HostX86\x86\c1xx.dll:      Version 19.14.26428.1
 C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.14.26428\bin\HostX86\x86\c2.dll:        Version 19.14.26428.1
 C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.14.26428\bin\HostX86\x86\link.exe:      Version 14.14.26428.1
 C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.14.26428\bin\HostX86\x86\mspdb140.dll:  Version 14.14.26428.1
 C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Tools\MSVC\14.14.26428\bin\HostX86\x86\1033\clui.dll: Version 19.14.26428.1

cl : Command line error D8003 : missing source filename

전체 출력을 복사하여 보고서에 붙여넣습니다.

명령줄

코드를 빌드하는 데 사용되는 정확한 명령줄, cl.exe 및 모든 인수가 필요합니다. 그러면 당사 머신에서 정확히 동일한 방식으로 빌드할 수 있습니다. 발견한 문제가 특정 인수 또는 인수 조합을 사용하여 빌드하는 경우에만 나타날 수도 있기 때문에 이 정보는 중요합니다.

이 정보를 찾을 수 있는 최상의 위치는 문제가 발생한 직후의 빌드 로그입니다. 이렇게 하면 문제를 초래할 수 있는 인수가 명령줄에 정확히 포함됩니다.

명령줄의 내용을 보고하려면

  1. CL.command.1.tlog 파일을 찾아서 엽니다. 기본적으로 이 파일은 \Visual Studio version\Projects\SolutionName\ProjectName\Configuration\ProjectName.tlog\CL.command.1.tlog의 Documents 폴더에 있거나 \Source\Repos\SolutionName\ProjectName\Configuration\ProjectName.tlog\CL.command.1.tlog 아래 User 폴더에 있습니다. 다른 빌드 시스템을 사용하거나 프로젝트의 기본 위치를 변경한 경우 이 파일이 다른 위치에 있을 수도 있습니다.

    이 파일 내에서 소스 코드 파일의 이름과 각 파일을 컴파일하는 데 사용된 명령줄 인수를 각 줄에 하나씩 찾을 수 있습니다.

  2. 문제가 발생하는 소스 코드 파일의 이름을 포함하는 줄을 찾습니다. 그 아래 줄에는 해당 cl.exe 명령 인수가 포함되어 있습니다.

전체 명령줄을 복사하여 보고서에 붙여넣습니다.

문제에 대한 설명

발견한 문제에 대한 자세한 설명이 필요합니다. 그러면 당사 머신에서 동일한 결과가 나타나는지 확인할 수 있습니다. 수행하려고 했던 작업과 예상한 결과도 알려주시면 때때로 도움이 됩니다.

적절한 설명은 도구 집합에서 표시한 정확한 오류 메시지 또는 표시된 정확한 런타임 동작을 제공합니다. 문제를 올바르게 재현했는지 확인하려면 이 정보가 필요합니다. 마지막 오류 메시지뿐 아니라 모든 컴파일러 출력을 포함합니다. 보고하신 문제를 초래한 모든 항목을 살펴보아야 합니다. 명령줄 컴파일러를 사용하여 문제를 복제할 수 있는 경우 해당 컴파일러 출력을 보내주시는 것이 좋습니다. IDE 및 다른 빌드 시스템은 표시되는 오류 메시지를 필터링하거나 오류 메시지의 첫 번째 줄만 캡처할 수 있습니다.

컴파일러가 잘못된 코드를 수락하고 진단을 생성하지 않는 것이 문제인 경우 보고서에 해당 내용을 포함합니다.

런타임 동작 문제를 보고하려는 경우 프로그램에서 출력되는 내용의 정확한 복사본과 예상 동작을 포함합니다. 이상적으로는 출력 문 자체에 이를 포함합니다(예: printf("This should be 5: %d\n", actual_result);). 프로그램이 충돌하거나 중단되는 경우 그 내용도 기록해 주세요.

발견한 해결 방법 등, 해당 문제를 진단하는 데 도움이 될 만한 기타 세부 정보도 기입합니다. 보고서에 같은 정보를 반복해서 포함하지 않도록 합니다.

재현

‘재현’은 완전한 자체 포함 소스 코드 예제입니다. 발견한 문제를 재현할 수 있게 보여 주기 때문에 ‘재현’이란 이름이 붙었습니다. 저희가 사용하는 컴퓨터에서 오류를 재현하려면 재현이 필요합니다. 코드는 그 자체만으로도 컴파일 및 실행되는 기본 실행 파일을 만들기에 충분해야 합니다. 또는 발견한 문제가 없다면 컴파일 및 실행됩니다. 재현은 코드 조각이 아닙니다. 완전한 함수 및 클래스가 있어야 하고, 표준 헤더에 대해서도 필요한 모든 #include 지시문을 포함하고 있어야 합니다.

좋은 재현의 조건

좋은 재현의 조건은 다음과 같습니다.

  • 최소. 재현은 발견한 문제를 정확하게 보여 주면서도 최대한 작아야 합니다. 재현이 복잡하거나 사실적일 필요는 없습니다. 표준 또는 문서화된 컴파일러 구현을 따르는 코드를 보여 주기만 하면 됩니다. 누락된 진단의 경우 재현에서 준수하지 않는 코드를 보여 주어야 합니다. 간단히 말해서, 문제를 보여 주는 데 필요한 만큼만 코드가 포함된 재현이 가장 좋습니다. 코드를 제거 또는 간소화하면서도 준수 상태를 유지하고 문제를 변경되지 않은 상태로 유지할 수 있도록 합니다. 제대로 실행되는 코드를 반례로 포함할 필요는 없습니다.

  • 자체 포함. 재현에서 불필요한 종속성을 피해야 합니다. 가능한 한, 타사 라이브러리 없이 문제를 재현할 수 있도록 합니다. 간단한 출력문 이외의 라이브러리 코드 없이 문제를 재현할 수 있도록 합니다(예: puts("this shouldn't compile");, std::cout << value;, printf("%d\n", value);). 사용자 헤더에 대한 참조 없이 예제를 단일 소스 코드 파일로 요약할 수 있다면 가장 좋습니다. 가능한 문제 원인으로 고려해야 하는 코드 양을 줄이면 도움이 됩니다.

  • 최신 컴파일러 버전 사용. 가능한 한, 재현에서 최신 도구 집합 버전의 최신 업데이트를 사용해야 합니다. 또는 다음 업데이트 또는 다음 주 릴리스의 최신 시험판 버전을 사용합니다. 이전 버전의 도구 집합에서 발견할 수 있는 문제가 최신 버전에서는 수정된 경우가 많습니다. 픽스는 예외적인 경우에만 이전 버전으로 백포팅됩니다.

  • 관련된 경우 다른 컴파일러에서 확인하세요. 포팅 가능한 C++ 코드를 포함하는 재현은 가능한 경우 다른 컴파일러에서 동작을 확인해야 합니다. 궁극적으로 C++ 표준에 따라 프로그램 정확성이 결정되며, 완벽한 컴파일러는 없습니다. 그러나 Clang 및 GCC는 진단 없이 코드를 수락하고 MSVC는 수락하지 않을 경우 당사 컴파일러에 버그가 있을 가능성이 큽니다. (그 외의 가능성으로 Unix와 Windows의 동작이 서로 다르거나 C++ 표준 구현의 수준이 다를 수 있습니다.) 모든 컴파일러에서 코드를 거부하는 경우 코드가 잘못되었을 가능성이 큽니다. 여러 오류 메시지를 보면 직접 문제를 진단하는 데 도움이 될 수 있습니다.

    ISO C++ 웹 사이트의 온라인 C++ 컴파일러에서 또는 GitHub의 엄선된 온라인 C++ 컴파일러 목록에서 코드를 테스트할 온라인 컴파일러 목록을 찾을 수 있습니다. 몇 가지 구체적인 예로 Wandbox컴파일러 탐색기가 있습니다.

    참고

    온라인 컴파일러 웹 사이트는 Microsoft와 관련이 없습니다. 많은 온라인 컴파일러 웹 사이트가 개인 프로젝트로 실행됩니다. 이러한 사이트 중에는 이 문서를 읽는 시점에 사용할 수 없는 곳도 있을 것입니다. 하지만 검색을 통해 사용 가능한 다른 사이트를 찾을 수 있습니다.

컴파일러, 링커 및 라이브러리의 문제는 특정 방식으로 드러나는 경향이 있습니다. 발견한 문제 종류에 따라 보고서에 포함해야 하는 재현 종류가 결정됩니다. 적절한 재현이 없으면 아무것도 조사할 수 없습니다. 발견할 수 있는 몇 가지 문제 종류는 다음과 같습니다. 각 문제 종류를 보고하기 위해 사용해야 하는 재현 종류를 생성하는 방법에 대한 지침도 포함되어 있습니다.

프런트 엔드(파서) 충돌

프런트 엔드 충돌은 컴파일러의 구문 분석 단계 중에 발생합니다. 일반적으로 컴파일러는 심각한 오류 C1001을 내보내고 오류가 발생한 소스 코드 파일 및 줄 번호를 참조합니다. msc1.cpp 파일을 언급하는 경우도 많지만 이 세부 정보는 무시해도 됩니다.

이러한 종류의 크래시를 보고하려면 전처리 재현을 제공합니다.

이러한 종류의 충돌에 대한 컴파일러 출력 예는 다음과 같습니다.

SandBoxHost.cpp
d:\o\dev\search\foundation\common\tools\sandbox\managed\managed.h(929):
        fatal error C1001: An internal error has occurred in the compiler.
(compiler file 'msc1.cpp', line 1369)
To work around this problem, try simplifying or changing the program near the
        locations listed above.
Please choose the Technical Support command on the Visual C++
Help menu, or open the Technical Support help file for more information
d:\o\dev\search\foundation\common\tools\sandbox\managed\managed.h(929):
        note: This diagnostic occurred in the compiler generated function
        'void Microsoft::Ceres::Common::Tools::Sandbox::SandBoxedProcess::Dispose(bool)'
Internal Compiler Error in d:\o\dev\otools\bin\x64\cl.exe.  You will be prompted
        to send an error report to Microsoft later.
INTERNAL COMPILER ERROR in 'd:\o\dev\otools\bin\x64\cl.exe'
    Please choose the Technical Support command on the Visual C++
    Help menu, or open the Technical Support help file for more information

백 엔드(코드 생성) 충돌

백 엔드 충돌은 컴파일러의 코드 생성 단계 중에 발생합니다. 일반적으로 컴파일러는 심각한 오류 C1001을 내보내며, 문제와 관련된 소스 코드 파일 및 줄 번호가 참조되지 않을 수 있습니다. compiler\utc\src\p2\main.c 파일을 언급하는 경우가 많지만 이 세부 정보는 무시해도 됩니다.

이러한 종류의 크래시를 보고하려면, cl.exe에 대한 /GL 명령줄 인수를 통해 설정된 LTCG(링크 타임 코드 생성)를 사용하는 경우 링크 재현을 제공합니다. 사용하지 않는 경우 전처리 재현을 대신 제공합니다.

다음은 LTCG가 사용되지 않는 백 엔드 크래시에 대한 컴파일러 출력 예제입니다. 컴파일러 출력이 다음과 같이 표시되는 경우 전처리 재현을 제공해야 합니다.

repro.cpp
\\officefile\public\tadg\vc14\comperror\repro.cpp(13) : fatal error C1001:
        An internal error has occurred in the compiler.
(compiler file 'f:\dd\vctools\compiler\utc\src\p2\main.c', line 230)
To work around this problem, try simplifying or changing the program near the
        locations listed above.
Please choose the Technical Support command on the Visual C++
Help menu, or open the Technical Support help file for more information
INTERNAL COMPILER ERROR in
        'C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\BIN\cl.exe'
    Please choose the Technical Support command on the Visual C++
    Help menu, or open the Technical Support help file for more information

INTERNAL COMPILER ERROR로 시작하는 줄에서 cl.exe 대신 link.exe가 언급되는 경우 LTCG가 사용된 것입니다. 이 경우 링크 재현을 제공합니다. 컴파일러 오류 메시지를 통해 LTCG 사용 여부를 확인할 수 없는 경우 명령줄 인수를 검사합니다. /GL 명령줄 인수에 대한 이전 단계에서, 빌드 로그를 통해 해당 인수를 복사했습니다.

링커 충돌

링커 충돌은 컴파일러가 실행된 후 연결 단계 중에 발생합니다. 일반적으로 링커는 링커 도구 오류 LNK1000을 내보냅니다.

참고 항목

출력에서 C1001이 언급되거나 링크 타임 코드 생성이 포함된 경우 대신 백 엔드(코드 생성) 크래시를 참조하세요.

이러한 종류의 크래시를 보고하려면 링크 재현을 제공합니다.

다음은 이러한 종류의 크래시에 대한 컴파일러 출력 예제입니다.

z:\foo.obj : error LNK1000: Internal error during IMAGE::Pass2

  Version 14.00.22816.0

  ExceptionCode            = C0000005
  ExceptionFlags           = 00000000
  ExceptionAddress         = 00007FF73C9ED0E6 (00007FF73C9E0000)
        "z:\tools\bin\x64\link.exe"
  NumberParameters         = 00000002
  ExceptionInformation[ 0] = 0000000000000000
  ExceptionInformation[ 1] = FFFFFFFFFFFFFFFF

CONTEXT:

  Rax    = 0000000000000400  R8     = 0000000000000000
  Rbx    = 000000655DF82580  R9     = 00007FF840D2E490
  Rcx    = 005C006B006F006F  R10    = 000000655F97E690
  Rdx    = 000000655F97E270  R11    = 0000000000000400
  Rsp    = 000000655F97E248  R12    = 0000000000000000
  Rbp    = 000000655F97EFB0  E13    = 0000000000000000
  Rsi    = 000000655DF82580  R14    = 000000655F97F390
  Rdi    = 0000000000000000  R15    = 0000000000000000
  Rip    = 00007FF73C9ED0E6  EFlags = 0000000000010206
  SegCs  = 0000000000000033  SegDs  = 000000000000002B
  SegSs  = 000000000000002B  SegEs  = 000000000000002B
  SegFs  = 0000000000000053  SegGs  = 000000000000002B
  Dr0    = 0000000000000000  Dr3    = 0000000000000000
  Dr1    = 0000000000000000  Dr6    = 0000000000000000
  Dr2    = 0000000000000000  Dr7    = 0000000000000000

증분 연결이 사용되고 초기 연결이 성공한 후에만(즉, 이후 증분 연결의 기준이 되는 첫 번째 전체 연결 후에만) 크래시가 발생한 경우 초기 연결이 완료된 후 수정한 소스 파일에 해당하는 개체(.obj) 및 라이브러리(.lib) 파일의 복사본도 제공합니다.

잘못된 코드 생성

잘못된 코드 생성은 드물지만 컴파일러에서 실수로 잘못된 코드가 생성되고, 이로 인해 런타임에 애플리케이션 작동이 중단되는 경우에 발생합니다. 컴파일러는 올바른 코드를 생성하거나 컴파일 시간에 문제를 검색해야 합니다. 발견한 문제로 인해 잘못된 코드가 생성된다고 의심하는 경우 보고서를 백 엔드(코드 생성) 크래시와 동일하게 처리합니다.

이러한 종류의 크래시를 보고하려면, cl.exe에 대한 /GL 명령줄 인수를 사용하는 경우 링크 재현을 제공합니다. 사용하지 않는 경우 전처리 재현을 제공합니다.

재현 생성 방법

문제의 원인을 추적하려면 좋은 재현이 중요합니다. 특정 종류의 재현에 대해 아래에 설명된 단계를 수행하기 전에 문제를 보여주는 코드를 최대한 압축합니다. 종속성, 필수 헤더 및 라이브러리를 제거하거나 최소화하려고 합니다. 가능한 경우, 사용되는 컴파일러 옵션 및 전처리기 정의를 제한합니다.

다음은 다양한 종류의 문제를 보고하는 데 사용할 다양한 종류의 재현을 생성하기 위한 지침입니다.

전처리 재현

‘전처리 재현’은 문제를 보여 주는 단일 소스 파일입니다. C 전처리기의 출력에서 생성됩니다. 전처리 재현을 만들려면 원래 재현 소스 파일에서 /P 컴파일러 옵션을 사용합니다. 이 옵션은 포함된 헤더를 인라인하여 다른 소스 및 헤더 파일에 대한 종속성을 제거합니다. 이 옵션은 매크로, #ifdef 조건, 로컬 환경에 종속될 수 있는 기타 전처리기 명령도 확인합니다.

참고

진행 중인 최신 구현을 대체하여 이미 문제가 해결되었는지 확인하는 경우가 많기 때문에, 전처리 재현은 표준 라이브러리 구현에 있는 버그의 결과로 나타날 수 있는 문제를 해결하기에는 유용하지 않습니다. 이 경우 재현을 전처리하지 말고, 문제를 단일 소스 파일로 줄일 수 없는 경우 코드를 .zip 파일 등으로 패키징하거나 IDE 프로젝트 재현을 사용하는 것이 좋습니다. 자세한 내용은 기타 재현을 참조하세요.

소스 코드 파일을 전처리하려면

  1. 명령줄의 내용을 보고하려면에 설명된 대로 재현을 빌드하는 데 사용된 명령줄 인수를 캡처합니다.

  2. 프로젝트를 빌드하는 데 사용된 Visual Studio 버전 및 구성 아키텍처와 일치하는 개발자 명령 프롬프트를 엽니다.

  3. 재현 프로젝트가 포함된 디렉터리로 변경합니다.

  4. 개발자 명령 프롬프트 콘솔 창에서 cl /P arguments filename.cpp 명령을 입력합니다. arguments에 대해 위에서 캡처한 인수 목록을 사용합니다. filename.cpp는 재현 소스 파일의 이름입니다. 이 명령은 재현에 사용된 명령줄을 복제하지만, 전처리기 패스 후 컴파일을 중지하고 전처리된 소스 코드를 filename.i에 씁니다.

C++/CX 소스 코드 파일을 전처리하거나 C++ 모듈 기능을 사용하는 경우 몇 가지 추가 단계가 필요합니다. 자세한 내용은 아래 섹션을 참조하세요.

전처리된 파일을 생성한 후에는 전처리된 파일을 컴파일할 때 여전히 문제가 재현되는지 확인하는 것이 좋습니다.

전처리된 파일에서 여전히 오류가 재현되는지 확인하려면

  1. 개발자 명령 프롬프트 콘솔 창에서 cl arguments /TP filename.i 명령을 입력하여 전처리된 파일을 C++ 소스 파일로 컴파일하도록 cl.exe에 지시합니다. arguments는 위에서 캡처한 것과 동일한 인수이지만 /D/I 인수가 제거되었습니다. 두 인수는 전처리된 파일에 이미 포함되었기 때문입니다. filename.i는 전처리된 파일의 이름입니다.

  2. 문제가 재현되는지 확인합니다.

마지막으로 전처리된 재현 filename.i를 보고서에 첨부합니다.

전처리된 C++/CX WinRT/UWP 코드 재현

실행 파일을 빌드하기 위해 C++/CX를 사용하는 경우 전처리된 재현을 만들고 유효성을 검사하는 데 필요한 몇 가지 추가 단계가 있습니다.

C++/CX 소스 코드를 전처리하려면

  1. 소스 코드 파일을 전처리하려면에서 설명된 대로 전처리된 소스 파일을 만듭니다.

  2. 생성된 filename.i 파일에서 #using 지시문을 검색합니다.

  3. 참조된 모든 파일의 목록을 만듭니다. Windows*.winmd 파일, platform.winmd 파일 및 mscorlib.dll은 그대로 둡니다.

전처리된 파일이 여전히 문제를 일으키는지 검증할 준비를 하려면,

  1. 전처리된 파일에 대한 새 디렉터리를 만들어 새 디렉터리에 복사합니다.

  2. #using 목록의 .winmd 파일을 새 디렉터리로 복사합니다.

  3. 새 디렉터리에서 빈 vccorlib.h 파일을 만듭니다.

  4. 전처리된 파일을 편집하여 mscorlib.dll에 대한 #using 지시문을 제거합니다.

  5. 전처리된 파일을 편집하여 절대 경로를 복사된 .winmd 파일의 기본 파일 이름으로 변경합니다.

위와 같이 전처리된 파일이 여전히 문제를 일으키는지 확인합니다.

전처리된 C++ 모듈 재현

C++ 컴파일러의 모듈 기능을 사용하는 경우 전처리된 재현을 만들고 유효성을 검사하는 데 필요한 몇 가지 단계가 있습니다.

모듈을 사용하는 소스 코드 파일을 전처리하려면

  1. 명령줄의 내용을 보고하려면에 설명된 대로 재현을 빌드하는 데 사용된 명령줄 인수를 캡처합니다.

  2. 프로젝트를 빌드하는 데 사용된 Visual Studio 버전 및 구성 아키텍처와 일치하는 개발자 명령 프롬프트를 엽니다.

  3. 재현 프로젝트가 포함된 디렉터리로 변경합니다.

  4. 개발자 명령 프롬프트 콘솔 창에서 cl /P arguments filename.cpp 명령을 입력합니다. arguments는 위에서 캡처한 인수이고, filename.cpp는 모듈을 사용하는 소스 파일의 이름입니다.

  5. 모듈 인터페이스(.ifc 출력)를 빌드한 재현 프로젝트를 포함하는 디렉터리로 변경합니다.

  6. 모듈 인터페이스를 빌드하는 데 사용된 명령줄 인수를 캡처합니다.

  7. 개발자 명령 프롬프트 콘솔 창에서 cl /P arguments modulename.ixx 명령을 입력합니다. arguments는 위에서 캡처한 인수이고, modulename.ixx는 모듈 인터페이스를 만드는 파일의 이름입니다.

전처리된 파일을 생성한 후에는 전처리된 파일을 사용할 때 여전히 문제가 재현되는지 확인하는 것이 좋습니다.

전처리된 파일에서 여전히 오류가 재현되는지 확인하려면

  1. 개발자 콘솔 창에서 재현 프로젝트가 포함된 디렉터리로 다시 변경합니다.

  2. 위와 같이 cl arguments /TP filename.i 명령을 입력하여 전처리된 파일을 C++ 소스 파일처럼 컴파일합니다.

  3. 전처리된 파일이 여전히 문제를 일으키는지 확인합니다.

마지막으로 .ifc 출력과 함께 전처리된 재현 파일(filename.i 및 modulename.i)을 보고서에 첨부합니다.

link reprolink_repro 환경 변수에 의해 지정되거나 /LINKREPRO 링커 옵션에 대한 인수로 지정되는 디렉터리의 링커 생성 콘텐츠입니다. 링크 타임에 발생하는 문제를 전체적으로 보여주는 빌드 아티팩트를 포함하고 있습니다. 예를 들어 LTCG(링크 타임 코드 생성)와 관련된 백 엔드 크래시 또는 링커 크래시가 있습니다. 이러한 빌드 아티팩트는 문제를 재현할 수 있도록 링커 입력으로 필요합니다. 이 환경 변수를 사용하면 링크 재현을 쉽게 만들 수 있습니다. 이 변수를 통해 링커의 기본 재현 생성 기능을 사용할 수 있습니다.

  1. 명령줄의 내용을 보고하려면에 설명된 대로 재현을 빌드하는 데 사용된 명령줄 인수를 캡처합니다.

  2. 프로젝트를 빌드하는 데 사용된 Visual Studio 버전 및 구성 아키텍처와 일치하는 개발자 명령 프롬프트를 엽니다.

  3. 개발자 명령 프롬프트 콘솔 창에서 재현 프로젝트가 포함된 디렉터리로 변경합니다.

  4. mkdir linkrepro를 입력하여 링크 재현에 사용할 linkrepro 디렉터리를 만듭니다. 다른 이름을 사용하여 다른 링크 재현을 캡처할 수 있습니다.

  5. set link_repro=linkrepro 명령을 입력하여 link_repro 환경 변수를 생성된 디렉터리로 설정합니다. 다른 디렉터리에서 빌드가 실행된 경우 더 복잡한 프로젝트와 마찬가지로 대신 link_repro를 link repro 디렉터리의 전체 경로로 설정합니다.

  6. Visual Studio에서 재현 프로젝트를 빌드하려면 개발자 명령 프롬프트 콘솔 창에서 devenv 명령을 입력합니다. 이렇게 하면 link_repro 환경 변수의 값이 Visual Studio에 표시됩니다. 명령줄에서 프로젝트를 빌드하려면 위에서 캡처한 명령줄 인수를 사용하여 재현 빌드를 복제합니다.

  7. 재현 프로젝트를 빌드하고 예상한 문제가 발생하는지 확인합니다.

  8. Visual Studio를 사용하여 빌드를 수행한 경우 Visual Studio를 닫습니다.

  9. 개발자 명령 프롬프트 콘솔 창에서 set link_repro= 명령을 입력하여 link_repro 환경 변수를 지웁니다.

마지막으로, 전체 linkrepro 디렉터리를 .zip 파일 등으로 압축하여 재현을 패키징하고 보고서에 첨부합니다.

/LINKREPRO 링커 옵션은 link_repro 환경 변수와 동일한 효과를 가집니다. /LINKREPROTARGET 옵션을 사용하여 생성된 링크 재현에 대해 필터링할 이름을 지정할 수 있습니다. /LINKREPROTARGET를 사용하려면 /OUT 링커 옵션도 지정해야 합니다.

  1. 링크 재현을 저장할 디렉터리를 만듭니다. 사용자가 만든 전체 디렉터리 경로를 directory-path로 지칭합니다. 공백을 포함하는 경우 경로 앞뒤에 큰따옴표를 사용합니다.

  2. /LINKREPRO:directory-path 명령을 링커 명령줄에 추가합니다. Visual Studio에서 프로젝트에 대한 속성 페이지 대화 상자를 엽니다. 구성 속성>링커>명령줄 속성 페이지를 선택합니다. 그런 다음 추가 옵션 상자에 /LINKREPRO:directory-path 옵션을 입력합니다. 확인을 선택하여 변경 내용을 저장합니다.

  3. 재현 프로젝트를 빌드하고 예상한 문제가 발생하는지 확인합니다.

마지막으로, 전체 directory-path 링크 재현 디렉터리를 .zip 파일 등으로 압축하여 재현을 패키징하고 보고서에 첨부합니다.

기타 재현

문제를 단일 소스 파일이나 전처리 재현으로 줄일 수 없고 문제에 링크 재현이 필요하지 않은 경우 IDE 프로젝트를 조사할 수 있습니다. 좋은 재현을 만드는 방법에 대한 모든 지침이 여전히 적용됩니다. 코드를 최소화하고 자체 포함해야 합니다. 문제가 최신 도구에서 발생해야 하며, 해당하는 경우 다른 컴파일러에서는 발견되지 않아야 합니다.

재현을 최소 IDE 프로젝트로 만든 다음 전체 디렉터리 구조를 .zip 파일 등으로 압축하여 패키징하고 보고서에 첨부합니다.

보고서를 보내는 방법

보고서를 보내는 몇 가지 좋은 방법이 있습니다. Visual Studio의 기본 제공 문제 보고 도구 또는 Visual Studio Developer Community 페이지를 사용할 수 있습니다. 이 페이지의 맨 아래에 제품 피드백 단추도 있습니다. IDE의 기본 제공 도구를 사용하여 스크린샷을 캡처하고 보고서를 구성할지 여부에 따라 선택이 달라집니다. IDE의 기본 제공 도구를 사용하지 않으려는 경우 개발자 커뮤니티 웹 사이트를 직접 사용할 수 있습니다.

참고

보고서를 제출하는 방법에 관계없이 Microsoft는 사용자의 개인 정보를 보호합니다. Microsoft는 모든 데이터 프라이버시 법률 및 규정을 준수할 것을 약속합니다. Microsoft에서 사용자가 보낸 데이터를 처리하는 방법에 대한 자세한 내용은 Microsoft 개인정보처리방침을 참조하세요.

문제 보고 도구 사용

Visual Studio의 문제 보고 도구는 Visual Studio 사용자가 마우스만 몇 번 클릭하여 문제를 보고할 수 있는 방법입니다. 발견한 문제에 대한 자세한 정보를 보내기 위한 간단한 양식이 팝업됩니다. 그러면 IDE를 벗어나지 않고도 보고서를 제출할 수 있습니다.

문제 보고 도구를 통한 문제 보고는 IDE에서 쉽고 간편하게 수행할 수 있습니다. 빠른 시작 검색 상자 옆에 있는 피드백 보내기 아이콘을 선택하여 제목 표시줄에서 액세스할 수 있습니다. 또는 메뉴 모음의 도움말>피드백 보내기>문제 보고에서 해당 메뉴를 찾을 수 있습니다.

문제를 보고하려는 경우 개발자 커뮤니티에서 유사한 문제를 검색합니다. 이전에 문제가 보고된 적이 있다면 보고서를 추천하고 세부 정보가 포함된 주석을 추가합니다. 유사한 문제가 표시되지 않는다면 Visual Studio 피드백 대화 상자의 새로운 문제 보고 단추를 선택하고 단계에 따라 문제를 보고합니다.

Visual Studio 개발자 커뮤니티 페이지 사용

Visual Studio 개발자 커뮤니티 페이지는 Visual Studio와 C++ 컴파일러, 도구 및 라이브러리에 대한 문제를 보고하고 해결 방법을 찾을 수 있는 또 다른 편리한 방법입니다. Visual Studio, Mac용 Visual Studio, .NET, C++, Azure DevOps, Azure DevOps Server를 위한 특정 Developer Community 페이지가 있습니다.

각 페이지 위쪽의 커뮤니티 탭 아래에 검색 상자가 있습니다. 이 검색 상자를 사용하여 자신의 문제와 유사한 문제를 보고하는 게시물을 찾을 수 있습니다. 자신의 문제와 관련된 솔루션이나 기타 유용한 정보가 이미 있을 수도 있습니다. 누군가가 이전에 동일한 문제를 보고한 경우 새 문제 보고서를 만드는 대신 해당 보고서를 추천하고 주석을 답니다. 주석을 달거나, 추천하거나, 새 문제를 보고하려면 Visual Studio 계정에 로그인해야 할 수 있습니다. 처음 로그인할 때 Developer Community 앱의 프로필 액세스에 동의해야 합니다.

C++ 컴파일러, 링커, 기타 도구 및 라이브러리와 관련된 문제의 경우 먼저 C++ Developer Community 페이지를 검색하세요. 문제를 검색했는데 아직 보고되지 않은 경우 검색 상자 옆에 있는 문제 보고 단추를 선택합니다. 재현 코드 및 명령줄, 스크린샷, 관련 토론 링크, 관련이 있고 유용하다고 생각되는 기타 정보를 포함할 수 있습니다.

초기 Developer Community 보고서의 정보는 항상 공개됩니다. 문제가 예상된다면 보고서 및 개인 정보 보호에 대한 다음 섹션을 참조하세요.

Visual Studio에서 발견할 수 있고 C++ 도구 집합과 관련이 없는 다른 종류의 문제(예: UI 문제, 손상된 IDE 기능 또는 일반 크래시)에 대해서는 IDE의 문제 보고 도구를 사용합니다. 스크린샷 기능 및 발견한 문제를 유발하는 UI 작업 기록 기능 때문에 이 방법이 가장 적합한 선택입니다. 이러한 종류의 오류는 Visual Studio Developer Community 사이트에서도 조회할 수 있습니다. 자세한 내용은 Visual Studio의 문제를 보고하는 방법을 참조하세요.

보고서 및 개인 정보

보고서의 모든 정보와 주석 및 회신은 기본적으로 공개됩니다. 이렇게 하면 다른 사용자가 발견한 문제, 해결 방법 및 임시 해결책을 전체 커뮤니티가 볼 수 있기 때문에 일반적으로 도움이 됩니다. 그러나 개인 정보 또는 지적 재산권을 이유로 데이터 또는 신원 공개가 우려되는 경우 이에 대한 옵션이 있습니다.

신원 공개가 우려되는 경우 세부 정보를 공개하지 않는 새로운 Microsoft 계정을 만듭니다. 이 계정을 사용하여 보고서를 만듭니다.

공개된 초기 보고서의 제목이나 내용에 비공개 내용을 넣지 마십시오. 대신 개별 주석을 통해 비공개로 세부 정보를 보냅니다. 보고서가 적합한 사람들에게 전달되도록 하려면 문제 보고서의 주제 목록에 cppcompiler를 포함시킵니다. 문제 보고서가 작성되면 이제 회신과 첨부 파일을 볼 수 있는 사용자를 지정할 수 있습니다.

개인 정보에 대한 문제 보고서를 작성하려면

  1. 작성한 보고서에서 메모 추가를 선택하여 문제에 대한 개인 설명을 작성합니다.

  2. 회신 편집기에서 제출취소 단추 아래의 드롭다운 컨트롤을 사용하여 회신 대상을 지정합니다. 지정한 사람만이 비공개 회신과 그 안에 포함된 이미지, 링크 또는 코드를 볼 수 있습니다. 중재자 및 원래 게시자가 볼 수 있음을 선택하여 Microsoft 직원과 본인만 볼 수 있도록 제한합니다.

  3. 재현에 필요한 설명 및 기타 정보, 이미지 및 첨부 파일을 추가합니다. 제출 단추를 선택하여 이 정보를 비공개로 보냅니다.

    첨부 파일의 크기는 2GB로 제한되며, 최대 10개 파일을 첨부할 수 있습니다. 이보다 큰 파일을 업로드하는 경우 프라이빗 주석으로 업로드 URL을 요청합니다.

이 주석 아래의 댓글에는 귀하가 지정한 것과 동일한 공개 설정 제한이 있습니다. 회신의 드롭다운 컨트롤에 제한된 표시 유형 상태가 올바르게 표시되지 않는 경우에도 마찬가지입니다.

개인 정보를 유지 관리하고 중요한 정보가 공개되지 않도록 주의해야 합니다. Microsoft와의 모든 상호 작용을 제한된 주석 아래의 회신에 유지합니다. 기타 다른 주석에 대한 회신은 실수로 중요한 정보가 누설될 수 있습니다.

C++ 설명서 문제를 보고하는 방법

GitHub 문제를 사용하여 설명서에 보고된 문제를 추적합니다. 이제 작성자 및 제품 팀과 더 다양한 방식으로 상호 작용할 수 있는 콘텐츠 페이지에서 직접 GitHub 문제를 만들 수 있습니다. 문서, 잘못된 코드 샘플, 혼란스러운 설명, 중요한 누락 또는 오타가 있는 문제가 있으면 편안하게 알려주세요. 페이지 아래쪽으로 스크롤하고 로그인을 선택하여 설명서 피드백을 제공합니다. GitHub 계정이 아직 없는 경우 만들어야 합니다. GitHub 계정이 있으면 모든 문서 문제와 해당 상태를 확인할 수 있습니다. 보고한 문제에 대한 변경 내용이 있을 경우 알림도 받게 됩니다. 자세한 내용은 피드백 시스템 블로그 항목을 참조하세요.

문서 피드백 단추를 사용하는 경우 GitHub에서 문서 문제를 만듭니다. 문제를 만든 페이지에 대한 몇 가지 정보가 문제에 자동으로 채워집니다. 이런 방법으로 문제가 있는 위치가 식별되므로 이 정보는 편집하지 않습니다. 문제에 대한 세부 정보와 원하는 경우 해결 방법 제안만 추가하면 됩니다. C++ 문서는 오픈 소스이므로, 원하는 경우 직접 수정 프로그램을 제출할 수 있습니다. 설명서에 기여할 수 있는 방법에 대한 자세한 내용은 GitHub의 기여 가이드를 참조하세요.