Visual Studio Code — установка и работа по документации Microsoft

ОБЯЗАТЕЛЬНО

Опытному пользователю

Связь с другими главами

Сравнение VS Code с Notepad++, Vim и IDE — в главе «Редакторы кода». Здесь — практическое руководство по официальной документации VS Code Docs (Microsoft).

Visual Studio Code — бесплатный кроссплатформенный редактор кода (Windows, macOS, Linux). Не путать с Visual Studio — полноценной IDE для .NET и C++. VS Code лёгкий (установщик < 200 МБ, на диске обычно < 500 МБ), обновляется еженедельно и расширяется через Visual Studio Marketplace.

---

Официальная документация — карта разделов

Тема	Документ Microsoft
Все разделы	VS Code Docs
Установка (обзор)	Setting up VS Code
Windows	Installing on Windows
Первые шаги	Getting Started tutorial
Язык интерфейса	Display Language
Темы оформления	Themes
Редактирование	Basic editing
IntelliSense	IntelliSense
Языки	Programming Languages
Терминал	Terminal Basics
Отладка	Debug configuration

Дополнительно: системные требования, дополнительные компоненты (Git, Node.js и др.), Insiders, portable mode.

---

Установка на Windows

Microsoft рекомендует User setup — не нужны права администратора, путь %LOCALAPPDATA%\Programs\Microsoft VS Code, плавные фоновые обновления.

Тип установки	Когда выбирать	Путь / особенности
User setup	Один пользователь на ПК (по умолчанию)	%LOCALAPPDATA%\Programs\Microsoft VS Code
System setup	VS Code для всех пользователей	Program Files, нужен администратор
ZIP	Портативная копия без установщика	Обновление вручную с каждым релизом

После установки установщик добавляет code в PATH. Перезапустите консоль и откройте папку проекта:

code .

Обновления: Help → Check for Updates (Windows/Linux) или Code → Check for Updates (macOS). Версию смотрите в Help → About (там же commit ID — важно для сборок Insiders).

После установки (по setup overview):

1. Установить Git, рантаймы языков, CLI-утилиты — additional components.
2. Поставить расширения с Marketplace.
3. Пройти tutorial Getting Started.

Windows для разработки

• WSL + расширение Remote - WSL — редактирование и отладка в контексте Linux на Windows. См. Developing in WSL.
• Windows Terminal — вкладки, PowerShell, WSL, UTF-8; VS Code может использовать его как внешний терминал.

UNC-пути (\\server\share): с версии 1.78.1 нужны доверенные хосты (security.allowedUNCHosts) или сетевой диск — см. Installing on Windows — UNC.

---

Рабочая область (workspace) и доверие

VS Code работает с отдельными файлами или с папкой (workspace).

1. File → Open Folder… — выберите каталог проекта.
2. При первом открытии — диалог Workspace Trust: «доверяете авторам?» — от этого зависит, выполнятся ли задачи, терминал и расширения без ограничений. Подробнее: Workspace Trust.

В workspace хранятся настройки только для этой папки, конфигурации отладки (.vscode/launch.json), восстановление открытых вкладок. См. Workspaces.

---

Интерфейс — краткий тур

По Getting Started:

Элемент	Назначение
Activity Bar (слева)	Переключение видов: Explorer, Search, Source Control, Run and Debug, Extensions, Chat
Primary Side Bar	Содержимое выбранного вида (файлы, Git, отладка)
Editor	Вкладки файлов; несколько редакторов рядом (вертикально/горизонтально)
Panel (снизу)	Терминал, Problems, Output, Debug Console
Status Bar	Кодировка, язык файла, ветка Git, ошибки

Command Palette — Ctrl+Shift+P:

• режим команд: префикс > (например, move terminal);
• Quick Open файлов: Ctrl+P (без >);
• поиск символов: # вместо >.

Настройки — Ctrl+, (Settings Editor). User — для всех проектов; Workspace — только для текущей папки (перекрывает user). Фильтр @modified показывает изменённые параметры. См. Settings.

---

Язык интерфейса (русификация)

По умолчанию меню, палитра команд и диалоги VS Code на английском. Русский и другие языки подключаются через Language Pack — расширение с переводами интерфейса (Display Language).

Через палитру команд

1. Ctrl+Shift+P — открыть Command Palette.
2. Набрать Configure Display Language (в русской локали — Настроить язык интерфейса) и выбрать команду.
3. В списке выбрать русский (ru / Русский).
4. Подтвердить перезапуск редактора — без него язык меню не сменится.

Если русского нет в списке, VS Code предложит установить расширение Russian Language Pack for Visual Studio Code (MS-CEINTL.vscode-language-pack-ru). После установки повторите шаги 1–4.

Установка пакета из терминала:

code --install-extension MS-CEINTL.vscode-language-pack-ru

Выбранный язык сохраняется в %APPDATA%\Code\User\locale.json (поле "locale": "ru").

Cursor и другие форки

Те же шаги работают в Cursor и других редакторах на базе VS Code: палитра команд, Language Pack, перезапуск. Идентификатор расширения русификации совпадает.

---

Темы оформления

Color Theme задаёт цвета редактора, боковых панелей и строки состояния. File Icon Theme — иконки файлов и папок в проводнике. Обзор: Themes.

Встроенные темы

Из коробки доступны, например, Dark+, Light+ и High Contrast. Их можно выбрать без установки расширений.

Установка темы из Marketplace

1. Ctrl+Shift+X — вкладка Extensions (Расширения).
2. В фильтре категорий выбрать Themes (Темы) или в поиске набрать theme.
3. Установить понравившееся расширение (One Dark Pro, Dracula Official, GitHub Theme и др.).

Применить цветовую тему

1. Ctrl+Shift+P.
2. Команда Preferences: Color Theme (в русской локали — Настроить цветовую тему).
3. Стрелками пролистать список — превью применяется сразу; Enter — зафиксировать выбор.

Перезапуск обычно не нужен. Тему можно закрепить в settings.json:

"workbench.colorTheme": "Default Dark Modern"

Иконки файлов: Ctrl+Shift+P → Preferences: File Icon Theme (Настроить тему значков файлов).

---

Базовое редактирование

По Basic editing:

Мультикурсор и выделение

Действие	Windows
Доп. курсор	Alt+Click
Курсоры выше/ниже	Ctrl+Alt+Up / Ctrl+Alt+Down
Следующее вхождение слова	Ctrl+D
Все вхождения выделения	Ctrl+Shift+L
Расширить/сузить выделение	Shift+Alt+Right / Shift+Alt+Left
Колоночное выделение	Shift+Alt + перетаскивание

Сохранение

По умолчанию — явно Ctrl+S. Auto Save — File → Auto Save или files.autoSave:

• off, afterDelay, onFocusChange, onWindowChange.

Hot exit — несохранённые изменения восстанавливаются после закрытия (files.hotExit).

Поиск и замена

• В файле: Ctrl+F / Ctrl+H
• По workspace: Ctrl+Shift+F / Ctrl+Shift+H
• Регулярные выражения и учёт регистра — кнопки в панели поиска

Справочник горячих клавиш: Keyboard Shortcuts Reference. Keymap-расширения (Vim, Sublime) — в Marketplace.

---

IntelliSense

IntelliSense — общее имя для автодополнения, подсказок параметров, Quick Info и списков членов (документация).

Из коробки (language service встроен): JavaScript, TypeScript, JSON, HTML, CSS, SCSS, Less. Для остальных языков — расширение с Marketplace (Python, C#, Java, Go и т.д.).

Приём	Клавиша
Вызвать подсказки	Ctrl+Space
Детали метода	Ctrl+Space повторно или > у пункта списка
Tab completion (лучшее совпадение по Tab)	настройка editor.tabCompletion: off / on / onlySnippets

CamelCase в списке: для createApplication можно набрать cra.

Типичные настройки в settings.json:

{
  "editor.quickSuggestions": { "other": true, "comments": false, "strings": false },
  "editor.suggestOnTriggerCharacters": true,
  "editor.parameterHints.enabled": true,
  "editor.wordBasedSuggestions": "matchingDocuments"
}

Если подсказки пропали — перезапустите VS Code; в огромных репозиториях исключите node_modules через files.exclude. Для JS без типов установите @types или пакеты с declaration files.

GitHub Copilot — отдельный слой AI-подсказок и чата; настройка: Copilot setup.

---

Языки программирования

По Programming Languages overview:

Уровень поддержки	Примеры
Встроенная подсветка + IntelliSense	JS/TS, JSON, HTML, CSS
Расширение (LSP, отладчик, линтер)	Python, C#, Java, Rust, PHP…

Возможности расширений (зависит от языка): подсветка, IntelliSense, линтинг, Go to Definition, Find References, отладка, рефакторинг.

Режим языка файла — индикатор в Status Bar (справа) или Ctrl+K M (Change Language Mode). Идентификатор языка (javascript, python) важен для регистра — см. language identifiers.

Связать расширение с нестандартным суффиксом:

"files.associations": {
  "*.myphp": "php",
  "**/somefolder/*.*": "php"
}

Новые пустые файлы по умолчанию:

"files.defaultLanguage": "html"

Языковые туториалы: C++, Python, Java — в энциклопедии для Java см. 294.md.

---

Встроенный терминал

По Terminal Basics:

Действие	Windows
Показать/скрыть панель терминала	Ctrl+`
Новый терминал	Ctrl+Shift+``
Внешний терминал	Ctrl+Shift+C

Терминал стартует в корне workspace, поддерживает git, mkdir и др., интегрируется с задачами и отладкой (ссылки на файлы/строки в выводе).

• Профили оболочек — PowerShell, Command Prompt, Git Bash, WSL — выбор в dropdown и terminal profiles.
• Несколько вкладок и split (Ctrl+Shift+5, Alt+клик по вкладке).
• Shell integration — метки команд в полосе прокрутки, навигация Ctrl+Up / Ctrl+Down между командами.
• Клик по URL/пути в выводе (Ctrl+Click) открывает браузер или файл.

В Restricted Mode (недоверенный workspace) терминал может быть заблокирован — см. Workspace Trust.

Связанные материалы энциклопедии: раздел «Терминал», PowerShell в VS Code.

---

Отладка и launch.json

Простой сценарий: F5 — VS Code попытается запустить активный файл. Для реальных проектов нужен файл .vscode/launch.json (Debug configuration).

Создание:

1. Run and Debug → create a launch.json file.
2. Выбрать среду (Node.js, Python, .NET и т.д.).
3. При необходимости дополнить конфигурации (Run → Add Configuration).

Пример для Node.js:

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch Program",
      "skipFiles": ["<node_internals>/**"],
      "program": "${workspaceFolder}/app.js"
    }
  ]
}

Поле	Смысл
type	Тип отладчика (node, cppdbg, python…)
request	launch — редактор стартует процесс; attach — подключение к уже запущенному
name	Имя в выпадающем списке Run and Debug
program, args, cwd, env	Что запускать и в какой среде

Переменные в путях: ${workspaceFolder}, ${file}, ${env:USERNAME} — Variables Reference.

Составные конфигурации (compounds) — параллельный запуск сервера и клиента. serverReadyAction — автоматически открыть URL в браузере, когда в консоли появится «listening on port 3000».

Перед отладкой часто запускают preLaunchTask из tasks.json (сборка). Подробнее: Debugging in VS Code.

---

Расширения, Git и CLI

Marketplace

Extensions view (Ctrl+Shift+X) — языки, темы оформления, Language Pack, отладчики, Remote SSH, Live Preview и т.д. Установка из терминала:

code --install-extension ms-python.python
code --install-extension ms-vscode.powershell

Для power user без полной разработки см. таблицу расширений в главе 3.

Git

Встроенный SCM: Source Control view → Initialize Repository → stage (+) → Commit. Нужен установленный Git. См. Source Control.

Полезные команды code

Команда	Действие
code .	Открыть текущую папку
code path\to\file	Открыть файл
code --install-extension id	Установить расширение
code --list-extensions	Список расширений

---

VS Code for the Web и альтернативы

• VS Code for the Web — браузерная версия без локальной установки.
• Insiders — ночные сборки для раннего теста функций (insiders).
• Portable mode — данные рядом с приложением (USB и переносимые среды).

Не путать с Visual Studio (полная IDE): см. главу 3.

---

Частые вопросы (по FAQ Microsoft)

Вопрос	Ответ
Нет пункта «New Project»?	VS Code не IDE с шаблонами — проект создают CLI (dotnet new, npm init, Yeoman)
«Unsupported installation»?	Повреждены файлы установки — переустановка; см. FAQ
Чистое удаление?	Удалить программу + папки %APPDATA%\Code и %USERPROFILE%\.vscode
Отключить автообновление?	FAQ — auto-updates

---

Практика

Пройдите официальный tutorial (папка, HTML/JS, расширение Live Preview, Git commit, breakpoint). Затем настройте workspace под свой стек — YAML, PowerShell, Remote SSH — по таблице в главе «Редакторы кода».

---

Под капотом — из нажатия клавиши к отладчику

Слой	Компонент
UI	Electron, Monaco Editor (редактор как в браузере)
Расширения	Extension Host (отдельный Node-процесс)
Язык	Language Server (Pylance, rust-analyzer, …)
Отладка	Debug Adapter Protocol → debugpy, lldb, Chrome debugger
Терминал	PTY → PowerShell/bash внутри вкладки
Git	Встроенный CLI git + UI diff

Workspace — папка + .vscode/settings.json + extensions.json (рекомендации команде). Multi-root — несколько папок в одном окне.

IntelliSense — не «магия»: LSP шлёт textDocument/completion при Ctrl+Space.

---

Опыт, мнение и истории

Первый breakpoint. Python-скрипт, красная точка, F5 — переменные в боковой панели. До этого print() в каждой строке; отладчик снял страх «чёрного ящика».

Remote SSH на Raspberry Pi. Правка скриптов с ноутбука, запуск на плате — не нужен Samba и синхронизация файлов.

Сломанное расширение. Одно расширение темы вешало сохранение — запуск code --disable-extensions, поиск виновника методом половинного отключения.

Мнение. VS Code — лучшая точка входа в «осознанный» софт на ПК: файлы, Git, терминал, отладка в одном окне. Официальный tutorial Microsoft на час — лучшая инвестиция после установки.

---

См. также

• Подборка документации — VS Code Docs
• Создание расширения VS Code
• Работа без мыши