/CGTHREADS (wątki kompilatora)/CGTHREADS (Compiler Threads)

Ustawia liczbę cl.exe wątków do użycia na potrzeby optymalizacji i generowania kodu, gdy zostanie określone generowanie kodu w czasie konsolidacji.Sets the number of cl.exe threads to use for optimization and code generation when link-time code generation is specified.

SkładniaSyntax

/CGTHREADS:[1-8]

ArgumentyArguments

Liczbanumber
Maksymalna liczba cl.exe wątków do użycia w zakresie od 1 do 8.The maximum number of threads for cl.exe to use, in the range 1 to 8.

UwagiRemarks

Opcja /cgthreads określa maksymalną liczbę wątków, cl.exe równolegle używa dla fazy optymalizacji i generowania kodu podczas kompilowania, gdy określono generowanie kodu w czasie konsolidacji (/LTCG).The /CGTHREADS option specifies the maximum number of threads cl.exe uses in parallel for the optimization and code-generation phases of compilation when link-time code generation (/LTCG) is specified. Domyślnie cl.exe używa czterech wątków, tak jakby określono /cgthreads: 4 .By default, cl.exe uses four threads, as if /CGTHREADS:4 were specified. Jeśli jest dostępnych więcej rdzeni procesora, większa number wartość może skrócić czas kompilacji.If more processor cores are available, a larger number value can improve build times.

Dla kompilacji można określić wiele poziomów równoległości.Multiple levels of parallelism can be specified for a build. Przełącznik msbuild.exe /maxcpucount określa liczbę procesów programu MSBuild, które mogą być uruchamiane równolegle.The msbuild.exe switch /maxcpucount specifies the number of MSBuild processes that can be run in parallel. Flaga programu /MP (kompilacja z wieloma procesami) określa liczbę procesów cl.exe, które jednocześnie kompilują pliki źródłowe.The /MP (Build with Multiple Processes) compiler flag specifies the number of cl.exe processes that simultaneously compile the source files. Opcja kompilatora /cgthreads określa liczbę wątków używanych przez proces poszczególnych cl.exe.The /cgthreads compiler option specifies the number of threads used by each cl.exe process. Ponieważ procesor może działać tylko w wielu wątkach w tym samym czasie, w którym występują rdzenie procesora, nie jest przydatne Określanie większych wartości dla wszystkich tych opcji w tym samym czasie i może być counterproductive.Because the processor can only run as many threads at the same time as there are processor cores, it's not useful to specify larger values for all of these options at the same time, and it can be counterproductive. Aby uzyskać więcej informacji o tym, jak kompilować projekty równolegle, zobacz kompilowanie wielu projektów równolegle.For more information about how to build projects in parallel, see Building Multiple Projects in Parallel.

Aby ustawić tę opcję konsolidatora w środowisku programowania Visual StudioTo set this linker option in the Visual Studio development environment

  1. Otwórz okno dialogowe strony właściwości projektu.Open the project's Property Pages dialog box. Aby uzyskać szczegółowe informacje, zobacz Ustawianie kompilatora C++ i właściwości kompilacji w programie Visual Studio.For details, see Set C++ compiler and build properties in Visual Studio.

  2. Wybierz Właściwości konfiguracji, folder konsolidatora .Select the Configuration Properties, Linker folder.

  3. Wybierz stronę właściwości wiersza polecenia .Select the Command Line property page.

  4. Zmodyfikuj właściwość Opcje dodatkowe , aby uwzględnić /cgthreads: number , gdzie number ma wartość od 1 do 8, a następnie wybierz OK.Modify the Additional Options property to include /CGTHREADS:number, where number is a value from 1 to 8, and then choose OK.

Aby programowo ustawić tę opcję konsolidatoraTo set this linker option programmatically

Zobacz teżSee also

MSVC Opcje konsolidatoraMSVC Linker Options
Dokumentacja konsolidatora MSVCMSVC linker reference