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

Вы можете создавать приложения C и C++ в командной строке с помощью средств, включенных в Visual Studio. Вы также можете скачать средства сборки Microsoft 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 for Visual Studio, чтобы найти загрузку Build Tools. При запуске скачаемого исполняемого файла он обновляет и запускает установщик Visual Studio.

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

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

При выборе одной из рабочих нагрузок C++ в установщике Visual Studio по умолчанию устанавливается определенная версия пакета средств сборки MSVC. Для Visual Studio 2022 и более ранних версий пакет организован по набору инструментов платформы (в формате версии v###), который включает все инструменты C и C++ для определённой версии Visual Studio. Начиная с Visual Studio 2026, версия MSVC отделяется от версии Visual Studio. Другими словами, начиная с Visual Studio 2026 г. пакет соответствует версии набора инструментов MSVC (версия v##.###), которая включает все средства C и C++ для этого конкретного пакета средств сборки MSVC.

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

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

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

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

Наборы инструментов, файлы команд и сочетания клавиш, добавляемые установщиком, зависят от процессора компьютера и параметров, которые вы выбираете во время установки. Всегда устанавливаются инструменты, размещенные на платформе x86, а также средства кросс-компиляции для сборки кода x86 и x64. Если у вас установлена 64-разрядная Windows, также устанавливаются хост-ориентированные средства x64 и кросс-платформенные средства, которые создают код для x86 и x64. При выборе дополнительных средств универсальная платформа Windows C++ также устанавливаются средства 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.
• Командная строка собственных средств x86. Задает среду для использования 32-разрядных средств x86 для создания 32-разрядного кода x86.
• Командная строка собственных средств x64. Задает среду для использования 64-разрядных средств x64 для создания 64-разрядного кода x64.
• Командная строка перекрёстных средств x86_x64. Задает среду для использования 32-разрядных средств x86 для создания 64-разрядного кода x64.
• Командная строка кросс-средств x64_x86. Задает среду для использования 64-разрядных средств x64 для создания 32-разрядного кода x86.

Папка меню Start и имена ярлыков зависят от установленной версии Visual Studio. Например, ярлык командной строки разработчика для Visual Studio 2022 называется Developer Command Prompt for VS 2022 в меню Start>Programs>Visual Studio 2022>Visual Studio Tools.

Примечание.

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

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

1. На рабочем столе откройте меню Windows Start. В Windows 11 выберите Все приложения, чтобы открыть список установленных приложений. В Windows 10 список открыт слева. Прокрутите список вниз, чтобы найти и открыть папку (а не приложение) для вашей версии Visual Studio, например Visual Studio 2022 или Visual Studio для версии 2026 и более поздних версий.
2. В папке выберите командную строку Developer для вашей версии Visual Studio. Это сочетание клавиш запускает окно командной строки разработчика, которое задает среду для использования 32-разрядных средств x86 для создания 32-разрядного кода x86. Если вы предпочитаете архитектуру сборки, отличную от используемой по умолчанию, выберите одну из командных строк собственных или кросс-средств, чтобы указать архитектуру хоста и целевую архитектуру.

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

Примечание.

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

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

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

Расположение файла команд зависит от установленной версии Visual Studio и выборов, сделанных во время установки. Для Visual Studio 2022 типичное расположение установки — C:\Program Files\Microsoft Visual Studio\2022\<edition>. <edition> может быть Community, Professional, Enterprise, 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 значений:

  vcvars_ver={value}	Result	Пример VS 2026	Пример VS 2022	Пример VS 2019	Пример VS 2017
  "Preview"	Используйте набор инструментов компилятора Visual Studio предварительной версии.	Supported	Не поддерживаются	Не поддерживаются	Не поддерживаются
  "14.0"	Используйте набор инструментов компилятора Visual Studio 2015.	Supported	Supported	Supported	Supported
  "14.xx"	Используйте последний установленный 14.xx.yyyyy набор инструментов.	"14.51"	"14.44"	"14.29"	"14.16"
  "14.xx.yyyyy"	Используйте конкретный полный номер версии.	"14.51.36231"	"14.44.35207"	"14.29.30133"	"14.16.27034"

• spectre_mode

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

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

1. В командной строке используйте команду CD, чтобы изменить каталог установки Visual Studio. Например, C:\Program Files\Microsoft Visual Studio\18\Professional, если вы используете Visual studio 2026. Затем используйте CD еще раз, чтобы изменить подкаталог, содержащий файлы команд для конкретной конфигурации. Для Visual Studio 2017 и более поздних версий используйте подкаталог VC\Auxiliary\Build. Для Visual Studio 2015 используйте подкаталог VC.

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

   vcvarsall.bat amd64_arm uwp
   

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

Откройте диалоговое окно "Свойства " для ярлыка командной строки разработчика, чтобы увидеть используемый целевой объект команды. Например, целевой объект ярлыка Командная строка разработчика для VS 2022 выглядит примерно так:

%comspec% /k "C:\Program Files\Microsoft Visual Studio\2022\Professional\Common7\Tools\VsDevCmd.bat"

Пакетные файлы для конкретных архитектур устанавливают параметр architecture и вызывают vcvarsall.bat. Вы можете передать этим batch-файлам те же параметры, что и vcvarsall.bat, или просто вызвать vcvarsall.bat напрямую. Чтобы указать параметры для собственного сочетания клавиш, добавьте их в конец команды в двойных кавычках. Чтобы использовать более раннюю версию набора инструментов компилятора, укажите номер версии.

Вы можете использовать только ARM64, начиная с Visual Studio 2026 года, так как целевой объект ARM32 был удален.

Ниже приведен ярлык для сборки кода ARM64 для UWP на 64-разрядной платформе с помощью последнего пакета SDK Windows. Поддержка ARM64 отображается в Visual Studio 2026 и более поздних версиях. Для более ранних версий показан выбор ARM32 в качестве целевой платформы.

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

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

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

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

• CL

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

• Link

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

При выполнении сборки с помощью командной строки, команда F1 для получения мгновенной справки недоступна. Вместо этого используйте поисковую систему для получения сведений о предупреждениях, ошибках и сообщениях. Также можно скачать и использовать автономные файлы справки. Чтобы использовать поиск в Microsoft 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 не используют среду командной строки для управления набором инструментов и библиотеками, используемыми.

См. также

• Пошаговое руководство. Компиляция собственной программы C++ в командной строке
• Пошаговое руководство. Компиляция программы на языке C из командной строки
• Пошаговое руководство. Компиляция программы C++/CLI в командной строке
• Пошаговое руководство. Компиляция программы C++/CX в командной строке
• Проекты и системы сборки
• /MD, /MT/LD (использование библиотеки времени исполнения)
• Параметры компилятора C/C++
• Параметры компоновщика MSVC
• Дополнительные средства сборки MSVC