Настройка VS Code для разработки: короткое руководство

Что понадобится

За 15–20 минут вы настроите VS Code для повседневной разработки: редактор будет аккуратнее сохранять файлы, терминал — открываться внутри проекта, а встроенная панель Git — показывать изменения. Руководство рассчитано на VS Code 1.99 и более поздние стабильные версии: отдельные названия пунктов меню могут отличаться между версиями и локализациями.

Перед началом установите VS Code с официального сайта и откройте папку проекта. Для работы с Git установите Git отдельно: редактор показывает его состояние, но не заменяет саму программу. Если вы пока выбираете язык, специальные расширения можно добавить позже.

Настройте редактор и проект

1. Откройте папку проекта. Выберите команду открытия папки в меню File, а не отдельный файл. Так VS Code сможет показывать дерево проекта и применять настройки, сохранённые внутри него. Проверка: папка и её файлы появились в боковой панели Explorer.
2. Задайте базовые настройки редактора. Откройте палитру команд через Ctrl+Shift+P в Windows и Linux или Cmd+Shift+P в macOS, найдите команду открытия пользовательского файла настроек JSON и добавьте приведённые ниже параметры. Если файл уже содержит настройки, вставьте только значения внутрь существующих фигурных скобок — не создавайте второй JSON-объект.

   {
     "editor.formatOnSave": true,
     "editor.minimap.enabled": false,
     "editor.tabSize": 2,
     "editor.detectIndentation": true,
     "files.insertFinalNewline": true,
     "files.trimTrailingWhitespace": true,
     "editor.wordWrap": "on"
   }

   Это личные настройки редактора. Форматирование при сохранении сработает, только если для языка установлен и выбран форматтер. Проверка: сохраните тестовый файл и убедитесь, что в конце есть перевод строки; длинная строка переносится в окне редактора, а не расширяет его.

3. Добавьте расширение для своего языка. Откройте Extensions через значок боковой панели или палитру команд и найдите расширение, которое публикует команда или проект языка. Например, для Python используется расширение Python от Microsoft. Проверьте имя издателя и совместимость, затем установите расширение. Не ставьте сразу несколько форматтеров для одного языка: они могут спорить за действие при сохранении. Проверка: откройте файл с соответствующим расширением и убедитесь, что VS Code распознал язык в строке состояния.
4. Проверьте терминал. Откройте встроенный терминал через меню Terminal. Он запускается в контексте открытой папки, но выбранная оболочка зависит от операционной системы и настроек VS Code. Выполните там безопасную команду просмотра файлов, например pwd в оболочке Unix или Get-Location в PowerShell. Проверка: терминал выводит путь к папке проекта.
5. Подключите Git. Откройте Source Control и посмотрите, распознал ли VS Code репозиторий. Если это новый проект, сначала создайте репозиторий средствами Git или командой инициализации в интерфейсе редактора. Перед первым коммитом проверьте список изменений и исключите файлы с секретами и локальными данными. Проверка: изменённый файл появляется в списке Source Control, а после коммита список изменений очищается.

Какие параметры оставить

Настройки выше — отправная точка, а не универсальный стандарт команды. Например, отступ в два пробела не подходит проекту, где уже принят размер в четыре. Сверьтесь с конфигурацией репозитория и договорённостями команды: локальная настройка не должна незаметно переписывать общий стиль.

Настройки проекта и личные настройки — не одно и то же

Пользовательские настройки относятся к вашему VS Code. Настройки рабочей области можно хранить в папке проекта, чтобы команда использовала общие параметры. Не переносите туда без проверки личные пути, параметры запуска с локальными адресами и секреты. Файл настроек проекта — обычная часть репозитория, если команда решила его отслеживать.

Рабочая область¹ — открытая в VS Code папка проекта или набор папок, с которыми редактор работает как с одним контекстом.

Хорошая настройка редактора не делает код лучше сама по себе. Её задача — не спорить с проектом и не добавлять команде лишнюю работу при каждом сохранении.

Если не получилось

• Форматирование не запускается. Проверьте, установлен ли форматтер для этого языка и выбран ли он в редакторе. Сам параметр editor.formatOnSave не устанавливает форматтер.
• VS Code не видит Git. Убедитесь, что Git установлен отдельно, затем перезапустите редактор. Если ошибка остаётся, проверьте, доступна ли команда git в системном терминале: проблема может быть в пути к программе, а не в расширении VS Code.
• После сохранения меняются отступы. Сравните настройки пользователя с правилами проекта и проверьте, не определяет ли редактор отступ автоматически по содержимому файла. Не применяйте форматирование ко всему репозиторию, пока не проверили его на одном файле.
• Расширение не появляется или не активируется. Проверьте, что открыли файл нужного типа, а расширение установлено и включено для этой рабочей области. Совместимость и требования к версии смотрите на странице расширения в Marketplace.

Что сделать дальше

Откройте один реальный файл проекта, сохраните его и просмотрите изменения в Source Control. Если форматирование изменило больше, чем вы ожидали, отмените правку и сверяйте настройки с правилами репозитория. Следующий разумный шаг — проверить настройки запуска и отладки именно для вашего языка: они зависят от проекта, поэтому добавлять универсальный конфиг наугад не стоит.

¹ В документации VS Code термин workspace используют для контекста открытого проекта; в простом случае это одна папка, но рабочая область может включать и несколько папок.