Как установить VS Code на macOS: подробное руководство 2026

Введение / Зачем это нужно

Visual Studio Code (VS Code) – это бесплатный, мощный и популярный редактор кода от Microsoft, который поддерживает множество языков программирования и имеет обширную экосистему расширений. Установка VS Code на macOS – это первый шаг к созданию эффективной среды разработки. Это руководство подробно описывает процесс установки, учитывая особенности macOS, включая Mac с процессорами Apple Silicon (M1/M2/M3) и Intel. После выполнения вы получите полностью рабочий редактор, готовый к использованию для проектов на Python, JavaScript, Java и других языках.

Требования / Подготовка

Перед началом установки убедитесь, что ваша система соответствует следующим требованиям:

• Операционная система: macOS 12.0 Monterey или новее (рекомендуется). VS Code также поддерживает macOS 11.0 Big Sur, но для совместимости с новыми функциями лучше обновить macOS.
• Процессор: Apple Silicon (ARM64) или Intel (x64). Важно скачать правильную версию для вашей архитектуры.
• Свободное место: около 500 МБ для установки плюс дополнительное место для проектов и расширений.
• Интернет: стабильное соединение для скачивания установщика (размер ~100 МБ) и последующей загрузки расширений.
• Права доступа: стандартные права пользователя macOS достаточны для установки в папку Applications. Если вы устанавливаете в другую директорию, могут потребоваться права администратора.
• Опционально: Homebrew – менеджер пакетов для macOS, если вы предпочитаете установку через командную строку.

Шаг 1: Скачайте установщик VS Code

1. Откройте браузер и перейдите на официальный сайт Visual Studio Code: https://code.visualstudio.com/.
2. На главной странице вы увидите большую синюю кнопку Download for macOS. Нажмите на нее.
3. Система предложит выбрать архитектуру:
   • Apple Silicon (arm64) – для Mac с чипами M1, M2, M3 и новее.
   • Intel (x64) – для Mac с процессорами Intel. Если не уверены, проверьте型号 вашего Mac: кликните на логотип Apple в левом верхнем углу → О этом Mac. В строке "Процессор" будет указано "Apple M1" или "Intel Core...".
4. Выбранный файл будет иметь имя вида VSCode-darwin-arm64.zip или VSCode-darwin-x64.zip и скачается в папку Загрузки (Downloads).

💡 Совет: Если вы используете несколько Mac или хотите сохранить установщик, скопируйте .zip файл в надежное место. Он может пригодиться для офлайн-установки.

Шаг 2: Установите VS Code в папку Applications

macOS не использует традиционные установщики (.exe или .msi); вместо этого приложения устанавливаются простым копированием в папку Applications.

1. Откройте папку Загрузки (Downloads) в Finder.
2. Найдите скачанный .zip файл (например, VSCode-darwin-arm64.zip).
3. Дважды кликните по .zip файлу, чтобы его распаковать. macOS создаст папку Visual Studio Code.app (или просто приложение с иконкой VS Code).
4. Перетащите приложение Visual Studio Code.app в папку Applications. Вы можете открыть папку Applications через Finder (в боковой панели) или через Launchpad.
5. После копирования вы можете удалить исходный .zip файл, чтобы освободить место.

⚠️ Важно: Не запускайте VS Code直接从 папки Загрузки – всегда перемещайте его в Applications. Это гарантирует, что приложение будет корректно зарегистрировано в системе и доступно из Launchpad или Spotlight.

Шаг 3: Первый запуск и базовая настройка

Теперь, когда VS Code установлен, его нужно запустить и провести начальную настройку.

1. Откройте папку Applications и дважды кликните по Visual Studio Code.
2. При первом запуске macOS может показать предупреждение: "ВSR код не может быть открыт, потому что он получен от неизвестного разработчика". Это стандартная мера безопасности Gatekeeper.
   • Чтобы обойти, откройте System Settings (Системные настройки) → Privacy & Security (Конфиденциальность и безопасность).
   • Прокрутите вниз до раздела Security (Безопасность). Вы увидите сообщение о блокировке VS Code. Нажмите Open Anyway (Открыть в любом случае).
   • Подтвердите действие в диалоговом окне. Затем попробуйте запустить VS Code снова.
3. VS Code откроется и предложит принять Лицензионное соглашение. Нажмите Accept (Принять).
4. Появится окно с предложением настроить синхронизацию через учетную запись Microsoft. Это полезно для синхронизации настроек, расширений и ключевых сочетаний между устройствами. Вы можете пропустить этот шаг или войти в учетную запись.
5. После этого вы увидите интерфейс VS Code: панель активности слева, редактор, терминал (если открыт). VS Code готов к использованию.

💡 Совет: Для быстрого доступа добавьте VS Code в Dock: запустите приложение, правой кнопкой по иконке в Dock → Options → Keep in Dock.

Шаг 4: Установите расширения для вашего стека технологий

VS Code становится по-настоящему мощным с расширениями. Установите те, которые нужны для ваших проектов.

1. В VS Code откройте Extensions (Расширения) через иконку в боковой панели или сочетание клавиш Cmd+Shift+X.
2. В строке поиска введите название расширения или тему (например, "Python", "Prettier", "GitLens").
3. Нажмите Install (Установить) для выбранного расширения.
4. После установки расширение активируется автоматически. Некоторые могут потребовать перезагрузки VS Code.

Популярные расширения для начала:

• Python – поддержка языка Python (от Microsoft).
• ESLint – линтинг для JavaScript/TypeScript.
• Prettier – форматирование кода.
• GitLens – улучшение работы с Git.
• Docker – работа с контейнерами.
• Material Icon Theme – тема иконок.

Альтернативный метод: установка через Homebrew

Если вы уже используете Homebrew, установка VS Code может быть выполнена из терминала. Это удобно для автоматизации или если вы предпочитаете CLI.

1. Откройте Terminal (Терминал) из папки Applications/Utilities или через Spotlight (Cmd+Пробел, введите "Terminal").
2. Выполните команду:

   brew install --cask visual-studio-code
   

   Homebrew автоматически скачает и установит последнюю версию VS Code в папку Applications.
3. После завершения установки запустите VS Code как описано в Шаге 3.
4. Для обновления VS Code через Homebrew используйте:

   brew upgrade --cask visual-studio-code
   

💡 Совет: Установка через Homebrew также упрощает удаление: brew uninstall --cask visual-studio-code.

Проверка результата

Чтобы убедиться, что установка прошла успешно, выполните следующие проверки:

1. Запуск приложения: Убедитесь, что VS Code открывается без ошибок. Должен появиться интерфейс с приветственным экраном.
2. Проверка версии: В меню VS Code выберите Help (Справка) → About (О программе). В окне должна отобразиться актуальная версия (например, 1.85.0 или выше) и информация о сборке.
3. Создание тестового файла: Создайте новый файл (File → New File или Cmd+N), введите простой код (например, print("Hello, VS Code!") для Python) и сохраните его. Убедитесь, что подсветка синтаксиса работает (например, для Python ключевые слова выделены цветом).
4. Работа с терминалом: Откройте встроенный терминал (Terminal → New Terminal или Ctrl+`). Выполните простую команду, например echo "Terminal works". Терминал должен вывести текст.
5. Расширения: Перейдите в Extensions и убедитесь, что установленные расширения отображаются и активны (статус "Enabled").

Если все эти шаги прошли успешно, VS Code установлен и готов к разработке.

Возможные проблемы

Хотя установка VS Code на macOS обычно проходит без сложностей, могут возникнуть некоторые проблемы. Вот решения для типичных случаев:

1. Ошибка Gatekeeper: "Не удается открыть, потому что от неизвестного разработчика"

• Причина: VS Code не подписан сертификатом Apple, или система блокирует его по умолчанию.
• Решение: Как описано в Шаге 3, разрешите запуск в System Settings > Privacy & Security → Open Anyway. Если опции нет, убедитесь, что вы скачали файл с официального сайта (не из сторонних источников). Временное отключение Gatekeeper через sudo spctl --master-disable не рекомендуется из-за рисков безопасности.

2. VS Code не запускается после установки

• Причина: Поврежденный загрузочный архив, конфликт с расширениями или недостаток прав.
• Решение:
  • Переустановите VS Code: удалите приложение из папки Applications (перетащите в Trash), скачайте заново с официального сайта и повторите установку.
  • Запустите VS Code из терминала, чтобы увидеть ошибки: open -a "Visual Studio Code". Ошибки будут выведены в консоль.
  • Проверьте права на папку Applications: ls -ld /Applications. Должна быть доступна для записи (обычно drwxr-xr-x). Если нет, используйте sudo chown -R $(whoami) /Applications (осторожно, это меняет владельца всей папки).

3. Проблемы с расширениями на Apple Silicon

• Причина: Некоторые расширения могут быть только для архитектуры x64 и работать через эмуляцию Rosetta 2, что может вызывать ошибки или низкую производительность.
• Решение:
  • Убедитесь, что вы установили нативную версию VS Code для Apple Silicon (arm64). Это можно проверить в Help > About – в строке "ARM64" должно быть "true".
  • Для расширений ищите версии с поддержкой ARM64. VS Code автоматически использует Rosetta 2 для x64 расширений, но лучше выбирать нативные.
  • Если расширение не работает, попробуйте установить альтернативное с похожим функционалом.

4. Зависание или медленная работа

• Причина: Большое количество установленных расширений, конфликты между ними или недостаток ресурсов.
• Решение:
  • Запустите VS Code в режиме отладки: code --disable-extensions из терминала. Если проблема исчезнет, виноваты расширения. Отключите или удалите лишние через Extensions.
  • Очистите кэш: удалите папку ~/Library/Application Support/Code (предварительно закройте VS Code). Будьте осторожны: это удалит настройки и расширения. Сделайте резервную копию, если нужно.
  • Увеличьте лимит памяти в настройках VS Code: добавьте "files.maxMemoryForLargeFilesMB": 4096 в settings.json (через Cmd+, → иконка {} в правом верхнем углу).

5. Ошибки при установке через Homebrew

• Причина: Проблемы с формулами Homebrew или конфликты версий.
• Решение:
  • Обновите Homebrew: brew update.
  • Проверьте, нет ли проблем с формулами: brew doctor.
  • Если установка не удается, попробуйте установить напрямую с сайта, как описано в основных шагах.
  • Для полной переустановки через Homebrew: brew uninstall --cask visual-studio-code && brew install --cask visual-studio-code.