Использование средств сборки C++ Майкрософт из командной строки

Вы можете создавать приложения C и C++ в командной строке с помощью средств, включенных в Visual Studio. Средства сборки Майкрософт C++ (MSVC) также можно скачать как автономный пакет. Если вы не планируете использовать его, вам не нужно устанавливать Visual Studio IDE.

Примечание.

В этой статье описывается, как настроить среду для использования отдельных компиляторов, линковщиков, менеджеров библиотек и других основных средств. Система сборки собственного проекта в Visual Studio на основе MSBuild не использует среду, как описано в этой статье. Дополнительные сведения об использовании средства MSBuild из командной строки см. в справочнике по использованию MSBuild в командной строке для C++.

Скачивание и установка инструментов

Если вы установили Visual Studio и рабочую нагрузку C++, у вас есть все средства командной строки. Сведения о том, как установить C++ и Visual Studio, см. в разделе Установка поддержки C++ в Visual Studio. Если требуется только набор инструментов командной строки, скачайте Build Tools для Visual Studio. На странице загрузки разверните раздел Tools для Visual Studio, чтобы найти загрузку средств сборки. При запуске скачаемого исполняемого файла он обновляет и запускает установщик Visual Studio. Чтобы установить только необходимые средства разработки C++, выберите рабочую нагрузку Разработка классических приложений на C++. В разделе Сведения об установке можно выбрать дополнительные библиотеки и наборы инструментов, чтобы добавить их. Чтобы создать код с помощью наборов инструментов Visual Studio 2015, 2017 или 2019, выберите необязательные средства сборки MSVC версии 140, версии 141 или версии 142. После проверки выбранных параметров щелкните Установить.

Практическое руководство. Использование программ командной строки

При выборе одной из рабочих нагрузок C++ в установщике Visual Studio по умолчанию устанавливается определенная версия пакета средств сборки MSVC. Для Visual Studio 2022 и более ранних версий это организовано набором инструментов платформы (формат версии V####), который содержит все средства C и C++ для конкретной версии Visual Studio. Для Visual Studio 2026 и более поздних версий эта версия состоит из версии MSVC (v##.###), которая содержит все средства C и C++ для этого конкретного пакета MSVC. Версия MSVC отделяется от версии Visual Studio. Эти средства включают компиляторы C/C++, линкеры, ассемблеры и другие средства сборки, а также соответствующие библиотеки и файлы заголовков. Все эти средства можно использовать в командной строке. Они также используются внутри Visual Studio IDE. Существуют отдельные компиляторы и средства для x86 и x64, которые создают код для платформ x86, x64, ARM и ARM64. Каждый набор инструментов для конкретного хоста и целевой архитектуры сборки хранится в собственном каталоге.

Для правильной работы инструментам требуется несколько переменных среды. Эти переменные используются для добавления инструментов в системный путь и для задания расположения файлов include, файлов библиотеки и пакетов SDK. Чтобы упростить процесс задания этих переменных среды, программа установки создает настраиваемые командные файлы, или пакетные файлы, во время установки. Вы можете запустить один из этих файлов команд, чтобы задать определенную архитектуру узла и целевой сборки, версию пакета SDK Windows и набор инструментов платформы. Для удобства установщик также создает ярлыки в меню "Пуск". Сочетания клавиш открывают окно командной строки разработчика с помощью этих командных файлов для определенных конфигураций хоста и цели. Эти ярлыки гарантируют, что все необходимые переменные окружения установлены и готовы к использованию.

Необходимые переменные среды зависят от установки и выбранной архитектуры сборки. Они также могут изменяться при обновлении продукта. Эта переменная является одной из причин, по которой рекомендуется использовать установленный ярлык командной строки или файл команд, а не задавать переменные среды самостоятельно.

Устанавливаемые наборы инструментов, командные файлы и ярлыки зависят от процессора компьютера и параметров, выбранных во время установки. Всегда устанавливаются инструменты, размещенные на платформе x86, а также средства кросс-компиляции для сборки кода x86 и x64. Если у вас установлена 64-разрядная Windows, также устанавливаются хост-ориентированные средства x64 и кросс-платформенные средства, которые создают код для x86 и x64. Если выбрать дополнительные средства C++ универсальная платформа Windows, то также устанавливаются средства x86 и x64, которые создают код ARM и ARM64. Эти и другие инструменты могут быть установлены в других рабочих нагрузках.

Переменные пути и среды для сборок командной строки

Программы командной строки MSVC используют переменные среды PATH, TMP, INCLUDE, LIB и LIBPATH, а также другие переменные среды, связанные с установленными средствами, платформами и пакетами SDK. Даже простая установка Visual Studio может задать двадцать или более переменных среды. Поэтому мы настоятельно рекомендуем использовать ярлык командной строки разработчика или один из настраиваемых файлов команд. Мы не рекомендуем задавать эти переменные в среде Windows самостоятельно.

Чтобы узнать, какие переменные среды задаются ярлыком командной строки разработчика, можно использовать команду SET. Откройте простое окно командной строки и сохраните выходные данные команды SET в качестве основы. Откройте окно командной строки разработчика и сохраните выходные данные команды SET для сравнения. Используйте средство диффа, например встроенный в Visual Studio, чтобы выделить переменные среды, заданные командной строкой разработчика. Дополнительные сведения о переменных среды компилятора и линкера см. в переменных среды CL.

Ярлыки командной строки для разработчика

Ярлыки командной строки устанавливаются в папку Visual Studio, соответствующую версии, в меню «Пуск» Windows. Ниже приведен список основных ярлыков командной строки и архитектуры сборки, которые они поддерживают:

• Командная строка разработчика — указывает среде использовать 32-разрядные собственные инструменты x86 для сборки 32-разрядного машинного кода x86.
• Командная строка Native Tools x86 — указывает среде использовать 32-разрядные собственные инструменты x86 для сборки 32-разрядного машинного кода x86.
• Командная строка Native Tools x64 — указывает среде использовать 64-разрядные собственные инструменты x64 для сборки 64-разрядного машинного кода x64.
• Командная строка Cross Tools x86_x64 — указывает среде использовать 32-разрядные собственные инструменты x86 для сборки 64-разрядного машинного кода x64.
• Командная строка Cross Tools x64_x86 — указывает среде использовать 64-разрядные собственные инструменты x64 для сборки 32-разрядного машинного кода x86.

Папка меню "Пуск" и имена ярлыков зависят от установленной версии Visual Studio. Если вы его задали, они также зависят от Псевдонима установки. Например, предположим, что вы установили Visual Studio 2022 и дали ему псевдоним Latest. Ярлык командной строки разработчика называется Developer Command Prompt for VS 2022 (Latest) в папке с именем Visual Studio 2022.

Примечание.

Некоторые инструменты командной строки или их опции могут требовать разрешений администратора. Если при их использовании возникают проблемы с разрешениями, мы рекомендуем открыть окно командной строки разработчика с помощью команды Запуск от имени администратора. Откройте контекстное меню для окна командной строки, а затем выберите команду Дополнительно > Запуск от имени администратора.

Открытие окна командной строки разработчика

1. На рабочем столе откройте меню Windows Start. В Windows 11 нажмите кнопку All apps, чтобы открыть список установленных приложений. В Windows 10 список открыт слева. Прокрутите список вниз, чтобы найти и открыть папку (а не приложение) для вашей версии Visual Studio, например Visual Studio 2022.

2. В папке выберите командную строку Developer для вашей версии Visual Studio. Этот ярлык запускает окно командной строки разработчика, которое использует архитектуру сборки по умолчанию: 32-разрядные собственные инструменты x86 для сборки 32-разрядного машинного кода x86. Если вы предпочитаете архитектуру сборки не по умолчанию, выберите одну из собственных командных строк или командную строку инструментов кросс-компиляции, чтобы указать хост и архитектуру целевой системы.

Более быстрый способ открыть командную строку разработчика — ввести запрос командная строка разработчика в поле поиска на рабочем столе. Затем выберите нужный результат.

Примечание.

По умолчанию рабочая директория в командной строке разработчика располагается в корне установки Visual Studio в каталоге Program Files. Это не подходящее расположение для кода и проектов. Перед созданием проекта измените текущий рабочий каталог на другое расположение. Интегрированная среда разработки создает проекты в пользовательском каталоге, как правило, в %USERPROFILE%\source\repos.

Расположения файлов команд разработчика

Если вам необходимо установить среду сборки в открытом окне командной строки, можно использовать один из командных файлов, созданных установщиком. Рекомендуем задавать среду в новом окне командной строки. Не рекомендуется менять среды позднее в том же окне командной строки.

Расположение файла команд зависит от установленной версии Visual Studio и выборов, сделанных во время установки. В Visual Studio 2022 типичное расположение установки в 64-разрядной системе находится в \Program Files\Майкрософт Visual Studio\2022\<edition>. Это <edition> может быть Сообщество, Профессиональный, Корпоративный, BuildTools или другой псевдоним, который вы предоставили.

Основной файл VsDevCmd.batкомандной строки разработчика находится в подкаталоге Common7\Tools . Если параметры не указаны, он указывает среде использовать собственные инструменты x86 для создания 32-разрядного кода x86.

Для настройки конкретных архитектур сборки доступны дополнительные командные файлы. Доступные файлы команд зависят от установленных Visual Studio рабочих нагрузок и параметров. В Visual Studio 2017 и Visual Studio 2019 вы найдете их в подкаталоге VC\Auxiliary\Build.

Эти командные файлы устанавливают параметры по умолчанию и вызывают VsDevCmd.bat, чтобы настроить указанное окружение архитектуры сборки. Обычная установка может включать следующие командные файлы:

Командный файл	Архитектуры хоста и цели
vcvars32.bat	Используйте 32-разрядные родные инструменты x86 для сборки 32-разрядного кода x86.
vcvars64.bat	Используйте нативные инструменты x64 для сборки 64-разрядного кода x64.
vcvarsx86_amd64.bat	Используйте 32-разрядные инструменты для кросс-компиляции x86, чтобы собрать 64-разрядный код x64.
vcvarsamd64_x86.bat	Используйте 64-разрядные встроенные кросс-инструменты x64 для сборки 32-разрядного кода x86.
vcvarsx86_arm.bat	Используйте 32-разрядные родные кросс-компиляционные инструменты x86 для сборки кода ARM.
vcvarsamd64_arm.bat	Используйте 64-битные нативные кросс-инструменты для x64, чтобы собирать код ARM.
vcvarsx86_arm64.bat	Используйте 32-разрядные нативные для x86 кросс-инструменты для сборки кода ARM64.
vcvarsamd64_arm64.bat	Используйте 64-битные x64-native кросс-компиляторы для сборки кода ARM64.
vcvarsall.bat	Используйте параметры, чтобы указать хостовую и целевую архитектуры, Windows SDK и варианты платформы. Список поддерживаемых вариантов можно вызвать параметром /help.

Внимание

Файл vcvarsall.bat и другие файлы команд Visual Studio могут отличаться от компьютера к компьютеру. Не заменяйте отсутствующий или поврежденный файл vcvarsall.bat файлом с другого компьютера. Повторно запустите установщик Visual Studio, чтобы заменить отсутствующий файл.

Файл vcvarsall.bat также может различаться в разных версиях. Если текущая версия Visual Studio установлена на компьютере с более ранней версией Visual Studio, не выполняйте vcvarsall.bat или другой файл команды Visual Studio из разных версий в одном окне командной строки.

Использование средств разработчика в существующем окне командной строки

Самый простой способ указать конкретную архитектуру сборки в имеющемся командном окне — использовать файл vcvarsall.bat. Используйте файл vcvarsall.bat, чтобы задать переменные среды для настройки командной строки для собственной 32- или 64-разрядной компиляции. Аргументы позволяют указать кросс-компиляцию для процессоров x86, x64, ARM или ARM64. Вы можете целиться на платформы Microsoft Store, универсальная платформа Windows или Windows Desktop. Можно даже указать, какой пакет SDK Windows использовать, и выбрать версию набора инструментов платформы.

При использовании без аргументов vcvarsall.bat настраивает переменные среды для использования текущего компилятора на основе x86 для 32-разрядных целевых объектов Windows Desktop. Можно добавить аргументы, чтобы настроить среду для использования собственных инструментов или инструментов кросс-компиляции. Файл vcvarsall.bat выводит сообщение об ошибке, если указанная конфигурация не установлена или недоступна на компьютере.

Синтаксис vcvarsall

vcvarsall.bat [architecture] [platform_type] []winsdk_version [] [-vcvars_ver=vcversion] [] [spectre_mode]

architecture
Этот необязательный аргумент указывает хост и целевую архитектуру, используемую. Если architecture не указано, используется среда сборки по умолчанию. Поддерживаются следующие аргументы:

architecture	Компилятор	Архитектура главного компьютера	Архитектура выходных данных сборки (целевая)
x86	нативный 32-разрядный x86	x86, x64	x86
x86_amd64 или x86_x64	x64 на x86 (кросс-компилятор)	x86, x64	х64
x86_arm	ARM для x86 (кросс-компилятор)	x86, x64	РУКА
x86_arm64	ARM64 на x86 (кросс)	x86, x64	ARM64
amd64 или x64	Родной 64-разрядный x64	х64	х64
amd64_x86 или x64_x86	x86 и x64 совместимость (взаимодействие)	х64	x86
amd64_arm или x64_arm	ARM для x64 (кросс-компилятор)	х64	РУКА
amd64_arm64 или x64_arm64	Кросс-компиляция ARM64 на x64	х64	ARM64

platform_type
Этот необязательный аргумент позволяет указать store или uwp в качестве типа платформы. По умолчанию среда настроена на сборку классических или консольных приложений.

winsdk_version
При необходимости указывает версию используемого пакета SDK Windows. По умолчанию используется последний установленный пакет SDK Windows. Чтобы указать версию пакета SDK Windows, можно использовать полный номер пакета SDK Windows, например 10.0.10240.0, или указать 8.1 для использования пакета SDK Windows 8.1.

vcversion
При необходимости задает используемый набор инструментов компилятора Visual Studio. По умолчанию среда использует текущий набор инструментов компилятора Visual Studio.

Используйте -vcvars_ver=14.2x.yy, чтобы указать определенную версию набора инструментов компилятора Visual Studio 2019 года.

Используйте -vcvars_ver=14.29, чтобы указать последнюю версию набора инструментов компилятора Visual Studio 2019 года.

Используйте -vcvars_ver=14.0, чтобы указать набор инструментов компилятора Visual Studio 2015.

spectre_mode
Пропустите этот параметр, чтобы использовать библиотеки без устранения уязвимостей Spectre. Используйте значение spectre, чтобы применять библиотеки с устранением рисков Spectre.

Настройка среды сборки в существующем окне командной строки

1. В командной строке используйте команду CD, чтобы изменить каталог установки Visual Studio. Затем используйте CD еще раз, чтобы изменить подкаталог, содержащий файлы команд для конкретной конфигурации. Для Visual Studio 2019 и Visual Studio 2017 используйте подкаталог VC\Auxiliary\Build. Для Visual Studio 2015 используйте подкаталог VC.

2. Введите команду для вашей среды разработки. Например, чтобы создать код ARM для UWP на 64-разрядной платформе, используя последний пакет SDK Windows и набор инструментов компилятора Visual Studio, используйте следующую командную строку:

   vcvarsall.bat amd64_arm uwp
   

Создайте собственный ярлык Командной строки Windows

Откройте диалоговое окно свойств для ярлыка командной строки разработчика, чтобы увидеть использованный целевой объект команды. Например, целевой объект для ярлыка командной строки Native Tools x64 для VS 2019 выглядит примерно следующим образом:

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat"

Пакетные файлы для конкретных архитектур устанавливают параметр architecture и вызывают vcvarsall.bat. Вы можете передать те же параметры в эти пакетные файлы, как вы бы передали их в файл vcvarsall.bat, или можно просто вызвать vcvarsall.bat напрямую. Чтобы задать параметры для командного ярлыка, добавьте их в конец команды в двойных кавычках. Например, вот ярлык для сборки кода ARM для UWP на 64-разрядной платформе с помощью последнего пакета SDK для Windows. Чтобы использовать более раннюю версию набора инструментов компилятора, укажите номер версии. Используйте подобный целевой объект команды в ярлыке:

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.29

Измените путь, чтобы отразить каталог установки Visual Studio. Файл vcvarsall.bat содержит дополнительные сведения о конкретных номерах версий.

Программы командной строки

Чтобы создать проект C/C++ в командной строке, Visual Studio предоставляет следующие средства командной строки:

CL
Используйте компилятор (cl.exe) для компиляции и связывания файлов исходного кода с приложениями, библиотеками и библиотеками DLL.

Link
Используйте компоновщик (link.exe) для связывания скомпилированных файлов объектов и библиотек в приложения и библиотеки DLL.

При выполнении сборки с помощью командной строки, команда F1 для получения мгновенной справки недоступна. Вместо этого используйте поисковую систему для получения сведений о предупреждениях, ошибках и сообщениях. Также можно скачать и использовать автономные файлы справки. Чтобы использовать поиск в Майкрософт Learn, введите запрос в поле поиска в верхней части любой статьи.

Средства управления проектами из командной строки

По умолчанию Visual Studio IDE использует собственные системы сборки проектов на основе MSBuild. Можно вызвать MSBuild непосредственно для создания проектов без использования интегрированной среды разработки. Вы также можете использовать команду devenv для создания проектов и решений Visual Studio. Visual Studio также поддерживает системы сборки на основе CMake или NMake.

MSBuild
Используйте MSBuild (msbuild.exe) и файл проекта (.vcxproj), чтобы настроить сборку и вызвать набор инструментов без загрузки Visual Studio IDE. Это эквивалентно выполнению проекта Build или Build Solution в Visual Studio IDE. MSBuild имеет преимущества по сравнению с интегрированной средой разработки при сборке в командной строке. Вам не нужно устанавливать полную среду IDE на всех серверах сборки и в конвейерах сборки. Так вы избегаете дополнительных издержек IDE. MSBuild выполняется в контейнерных средах сборки и поддерживает двоичное средство ведения журнала.

DEVENV
Используйте DEVENV (devenv.exe) вместе с параметром командной строки, например /Build или /Clean для выполнения определенных команд сборки без отображения Visual Studio IDE.

CMake
CMake (cmake.exe) — это кроссплатформенное средство с открытым исходным кодом для определения процессов сборки, выполняемых на нескольких платформах. CMake может настраивать и контролировать собственные средства сборки для поддерживаемых платформ, например MSBuild и Make. См. документацию по CMake для получения дополнительных сведений.

NMAKE
Используйте NMAKE (nmake.exe) для создания проектов C++ с помощью традиционного файла makefile.

Примечание.

Начиная с Visual Studio 2019 версии 16.5, MSBuild и DEVENV не используют среду командной строки для управления набором инструментов и библиотеками, используемыми.

В этом разделе

В этих статьях показано, как создавать приложения в командной строке, а также описано, как настроить среду сборки из командной строки. В некоторых из них показано, как использовать 64-разрядные наборы инструментов и целевые платформы x86, x64, ARM и ARM64. Они также описывают использование средств сборки из командной строки MSBuild и NMAKE.

Пошаговое руководство. Компиляция собственной программы C++ в командной строке
Содержит пример создания и компиляции программы на языке C++ из командной строки.

Пошаговое руководство. Компиляция программы на языке C из командной строки
Описывается компиляция программы, написанной на языке программирования C.

Пошаговое руководство. Компиляция программы C++/CLI в командной строке
Описывает создание и компиляцию программы C++/CLI, использующую платформу .NET Framework.

Пошаговое руководство. Компиляция программы C++/CX в командной строке
Описывает создание и компиляцию программы C++/CX, использующую среда выполнения Windows.

NMAKE reference (Справочник по NMAKE)
Содержит ссылки на статьи, описывающие программу обслуживания программы Майкрософт (NMAKE.EXE).

MSBuild в командной строке — C++
Содержит ссылки на статьи, которые обсуждают использование msbuild.exe из командной строки.

Связанные разделы

/MD, /MT/LD (использование библиотеки времени исполнения)
Описывается, как использовать эти параметры компилятора для работы с библиотекой времени выполнения в режиме отладки или выпуска.

Параметры компилятора C/C++
Содержит ссылки на статьи, которые обсуждают параметры компилятора C и C++ и CL.exe.

Параметры компоновщика MSVC
Содержит ссылки на статьи, которые обсуждают параметры связывателя и LINK.exe.

Дополнительные средства сборки MSVC
Содержит ссылки на средства сборки C/C++, включенные в Visual Studio.

См. также

Проекты и системы сборки