Среда разработки Visual Studio Code содержит мощный встроенный интерфейс командной строки, позволяющий управлять запуском редактора кода. Вы можете открывать файлы, устанавливать расширения, менять язык отображения и вывод диагностики с помощью опций (ключей) командной строки.
Если вы хотите запустить командную строку из среды разработки VS Code, см. описание возможностей встроенного терминала [2].
Для получения обзорной подсказки по командной строке VS Code откройте терминал или командную строку, и введите команду code --help. В ответ вы увидите версию, пример применения и список опций командной строки.
$ code --help
Visual Studio Code 1.71.2
Usage: code [options][paths...]
Для чтения из stdin добавьте '-' (например 'ps aux | grep code | code -')
Опции:
-d --diff < file> < file> Сравнение двух файлов друг с другом.
-m --merge < path1> < path2 > < base> < result> Выполнение слияния по принципу дерева,
с предоставлением путей для двух модифицированных
версий файла, общего оригинала обоих
модифицированных версий, и выходного файла для
сохранения результатов слияния.
-a --add < folder> Добавление папки (папок) к последнему активному
окну.
-g --goto < file:line[:character]> Открыть файл по указанному пути, на указанной
строе и позиции символа.
-n --new-window Принудительно открыть новое окно.
-r --reuse-window Принудительно открыть файл или папку в уже
открытое окно.
-w --wait Ожидание закрытия файлов перед возвратом.
--locale < locale> Установить используемую локаль (например en-US
или zh-TW).
--user-data-dir < dir> Указывает директорию, которая хранит данные
пользователя. Может использоваться для открытия
нескольких отдельных экземпляров Code.
--profile < settingsProfileName> Откроет предоставленную папку или workspace
с указанным профилем и свяжет профиль с workspace.
Если профиль не существует, то будет создан новый.
Чтобы опция дала эффект, должна быть предоставлена
папка или workspace.
-h --help Печать подсказки по использованию.
Управление расширениями
--extensions-dir < dir> Установит путь корня для расширений.
--list-extensions Выведет список установленных расширений.
--show-versions Покажет версии установленных расширений, когда
используется --list-extensions.
--category < category> Фильтрует установленные расширения по предоставленной
категории, когда используется --list-extensions.
--install-extension < ext-id | path> Установит или обновит расширение. В аргументе указывается
либо идентификатор (id) расширения, либо путь до VSIX.
Идентификатор расширения представлен в виде
'${publisher}.${name}'. Используйте аргумент '--force',
чтобы обновить до последней версии. Для установки
определенной версии предоставьте '@${version}'.
Пример: 'vscode.csharp@1.2.3'.
--pre-release Установит версию предварительного релиза расширения,
когда используется --install-extension.
--uninstall-extension < ext-id> Деинсталлирует расширение.
--enable-proposed-api < ext-id> Разрешает предлагаемые функции API для расширений.
Может принимать один или большее количество
идентификаторов ID для индивидуального управления
расширениями.
Решение проблем
-v --version Печать версии.
--verbose Печать подробного вывода (подразумевает --wait).
--log < level> Используемый уровень лога. По умолчанию установлен уровень
'info'. Допустимы значения 'critical', 'error', 'warn',
'info', 'debug', 'trace', 'off'.
-s --status Печать использования процессов и диагностической информации.
--prof-startup Запуск профайлера CPU при старте (startup).
--disable-extensions Запрет всех установленных расширений.
--disable-extension < ext-id> Запрет расширения.
--sync < on | off> Включение или выключение синхронизации.
--inspect-extensions < port> Позволяет выполнять отладку и профайлинг расширений.
Проверьте инструментарий разработчика для URI соединения.
--inspect-brk-extensions < port> Позволяет выполнять отладку и профайлинг расширений
с хостом расширений, приостановленном после старта.
Проверьте инструментарий разработчика для URI соединения.
--disable-gpu Запрет аппаратного ускорения GPU.
--max-memory < memory> Максимальный объём памяти для окна (в мегабайтах).
--telemetry Покажет все события телеметрии, которые собирает VS code.
Запуск из командной строки. Вы можете запустить VS Code из командной строки для быстрого открытия файла, папки, или проекта. Обычно VS Code открывают в контексте папки (например, корневой папки проекта). Чтобы сделать это, запустите терминал или приглашение командной строки, командами cd перейдите в каталог проекта, и введите команду code .:
Пользователи macOS должны сначала запустить команду (Shell Command: Install 'code' command in PATH) для добавления исполняемого кода среды VS Code в переменную окружения PATH. Для помощи см. руководство по установке VS Code на macOS [3].
Инсталляции Windows и Linux должны добавить место нахождения бинарников VS Code в системные пути поиска. Если это не тот случай, то вы можете добавить вручную путь в переменную окружения Path (%PATH% на Windows и $PATH на Linux). Например, на Windows среда VS Code может быть установлена в папку AppData\Local\Programs\Microsoft VS Code\bin. Чтобы получить инструкции по установке, специфичные для платформы, см. [4].
Открытие файлов и папок. Иногда вам понадобится открыть или создать файл. Если указанный файл не существует, то VS Code создаст его вместе с любым количеством промежуточных директорий:
Как для файлов, так и для папок, вы можете использовать абсолютные или относительные пути. Относительные пути отсчитываются от текущей директории терминала или командной строки, где вы запустили команду code.
Если вы указали в командной строке больше одного файла, запустится только один экземпляр VS Code. Если в командной строке вы создадите больше одной папки, то VS Code создаст Multi-root Workspace [5], включающее каждую папку.
Аргумент
Описание
file
Имя файла, который должен быть открыт. Если этот файл не существует, то он будет создан и помечен как редактируемый. Можно указать в командной строке несколько параметров file (файл1, файл2, ... и т. д.), которые отделяются друг от друга пробелом.
file:line[:character]
Используется с аргументом -g. Имя файла file для открытия на указанной строке и опционально на указанной позиции символа в строке.
folder
Имя папки для открытия. Можно указать несколько папок, и будет создано Multi-root Workspace [5].
