Установка Visual Studio Code на Debian 13, 12, 11: подробное руководство

Visual Studio Code (VS Code) — это легковесный, но мощный редактор исходного кода, который поддерживает отладку, встроенный Git, подсветку синтаксиса, интеллектуальное автодополнение и обширную библиотеку расширений. VS Code подходит для веб-разработки на JavaScript, написания скриптов на Python, создания бэкендов на PHP и управления Docker-контейнерами.

В этом обновлённом руководстве я покажу три способа установки VS Code на Debian:

  • Microsoft APT репозиторий — стандартный способ, с поддержкой amd64, arm64, armhf
  • extrepo — если вы уже используете этот инструмент
  • Flatpak — изолированная установка (песочница)
МетодАрхитектурыОбновленияДля кого
Microsoft APTamd64, arm64, armhfЧерез apt upgradeСтандартный способ,
полная совместимость с
расширениями
extrepoamd64Через apt upgradeЕсли вы уже используете
extrepo
Flatpakx86_64, aarch64Через flatpak updateИзоляция, удобно, если не
хотите засорять систему

⚠️ Важно: VS Code официально поддерживает amd64, arm64, armhf. Если ваша архитектура не входит в этот список — используйте браузерную версию.

⚠️ На ARM-устройствах (например, Raspberry Pi) VS Code работает, но учитывайте, что некоторые тяжёлые расширения могут работать медленнее, а аппаратное ускорение видео может быть недоступно.

Оглавление

Оглавление

Предварительные требования

Перед установкой убедитесь, что:

  • У вас установлена Debian 11, 12 или 13
  • Вы имеете права sudo (администратора)

⚠️ ВАЖНО: Проверьте права sudo перед установкой

Если вы не уверены, есть ли у вашего пользователя права администратора, выполните в терминале:

sudo -l

Что делает: Проверяет, есть ли у текущего пользователя права суперпользователя.

⚠️ Пароль при первом запуске! В зависимости от настроек в /etc/sudoers, при первом выполнении sudo -l в текущей сессии система может запросить ваш пароль (если не активировано правило NOPASSWD).

✅ Ожидаемый результат: Список разрешённых команд. Если видите (ALL : ALL) ALL — у вас полный доступ.

❌ Если видите ошибку user is not in the sudoers file или may not run sudo — сначала пройдите наше руководство по настройке sudo. Без этого дальнейшие шаги не сработают.

Обновление системы

Перед установкой всегда обновляйте список пакетов:

sudo apt update
sudo apt upgrade

Что делает:

  • sudo — права суперпользователя
  • apt update — обновляет список доступных пакетов
  • apt upgrade — обновляет все установленные пакеты

Зачем: Это стандартная практика безопасности перед установкой нового ПО.

💡 Примечание: Флаг -y автоматически подтверждает все действия. В обучающих инструкциях его лучше не использовать: так вы видите список пакетов и можете отменить установку, если что-то выглядит подозрительно. Если вы уверены в своих действиях, можно добавить -y.

Установка вспомогательных пакетов

sudo apt install curl gpg ca-certificates

Что делает: Устанавливает инструменты для скачивания и проверки ключей.

Способ 1: Установка из официального репозитория Microsoft (стандартный способ)

Этот метод подходит для любых архитектур, поддерживаемых Microsoft (amd64, arm64, armhf).

Когда выбирать этот способ: Стандартный способ, полная совместимость с расширениями.

Шаг 1: Проверьте архитектуру системы

ARCH=$(dpkg --print-architecture)
echo "Ваша архитектура: $ARCH"

Microsoft поддерживает: amd64, arm64, armhf.

Шаг 2: Импортируйте GPG-ключ Microsoft

curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor --yes -o /usr/share/keyrings/microsoft.gpg

Что делает: Скачивает публичный ключ Microsoft и сохраняет его в формате, понятном APT.

Шаг 3: Добавьте репозиторий (с проверкой архитектуры)

# Создаём файл репозитория с учётом архитектуры системы (amd64/arm64/armhf)
ARCH=$(dpkg --print-architecture)

case "$ARCH" in
  amd64 | arm64 | armhf)
    sudo tee /etc/apt/sources.list.d/vscode.sources > /dev/null <<EOF
Types: deb
URIs: https://packages.microsoft.com/repos/code
Suites: stable
Components: main
Architectures: $ARCH
Signed-By: /usr/share/keyrings/microsoft.gpg
EOF
    echo "Репозиторий VS Code успешно добавлен для архитектуры $ARCH"
    ;;
  *)
    echo "Ваша архитектура ($ARCH) не поддерживается VS Code."
    echo "Используйте браузерную версию или Flatpak."
    exit 1
    ;;
esac

Что делает: Создаёт файл репозитория в формате DEB822 с учётом архитектуры системы.

Шаг 4: Обновите список пакетов и установите VS Code

sudo apt update
sudo apt install code

Шаг 5: Установка Insiders-версии (опционально)

sudo apt install code-insiders

Что делает: Устанавливает Insiders-версию VS Code (ежедневные сборки с новыми функциями).

Способ 2: Установка через extrepo (альтернативный)

Когда выбирать этот способ: Если вы уже используете extrepo.

⚠️ Примечание: extrepo — это сторонний инструмент, который не входит в репозитории Debian по умолчанию. Для большинства пользователей Debian рекомендуется использовать официальный репозиторий Microsoft.

Шаг 1: Установите extrepo

sudo apt install extrepo

Шаг 2: Включите политику non-free

# Проверяем, включена ли политика non-free
if grep -q '^[[:space:]]*- non-free' /etc/extrepo/config.yaml; then
  echo "Политика non-free уже включена."
else
  echo "Добавляем политику non-free..."
  sudo cp /etc/extrepo/config.yaml /etc/extrepo/config.yaml.bak
  sudo sed -i '/^policies:/a  - non-free' /etc/extrepo/config.yaml
  echo "Политика non-free успешно включена."
fi

Шаг 3: Добавьте репозиторий VS Code

sudo extrepo enable vscode
sudo apt update

Шаг 4: Проверьте, что пакет виден

apt-cache policy code

✅ Ожидаемый вывод: Должна быть строка с packages.microsoft.com/repos/code.

Шаг 5: Установите VS Code

sudo apt install code

Способ 3: Установка через Flatpak

Когда выбирать этот способ: Изоляция, удобно, если не хотите засорять систему.

⚠️ Важно: Flatpak-пакеты устанавливаются в пользовательское пространство и не требуют прав суперпользователя. Не используйте sudo с командами flatpak.

⚠️ Перед установкой: Убедитесь, что Flatpak установлен. Если нет — пройдите наше руководство по установке Flatpak на Debian.

Шаг 1: Добавьте репозиторий Flathub

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

Шаг 2: Установите VS Code

flatpak install flathub com.visualstudio.code

Шаг 3: Проверьте установку

flatpak info com.visualstudio.code

✅ Ожидаемый вывод: ID: com.visualstudio.code, Version: 1.x.x

Запуск Visual Studio Code

МетодКоманда запуска
APT (Microsoft или extrepo)code
Insiders-версияcode-insiders
Flatpakflatpak run com.visualstudio.code

Запуск из меню приложений

Найдите Visual Studio Code в меню приложений (категория «Разработка»).

Если VS Code не открывается

  • Проверьте, какая версия установлена: code --version.
  • Если пишет «command not found» — перезапустите терминал или выполните source ~/.bashrc (или ~/.zshrc).
  • Если запускается, но сразу падает — посмотрите логи: code --verbose (в терминале будут ошибки инициализации).

Настройка телеметрии (опционально)

⚠️ Телеметрия в VS Code. По умолчанию VS Code отправляет телеметрические данные в Microsoft. Если хотите отключить:

Способ 1 (через интерфейс):

  1. Откройте VS Code.
  2. Перейдите в File → Preferences → Settings (или Ctrl+,).
  3. В поиске введите telemetry.
  4. Снимите галочку с Telemetry: Enable Telemetry.

Способ 2 (через конфигурационный файл):

mkdir -p ~/.config/Code/User
cat > ~/.config/Code/User/settings.json <<EOF
{
  "telemetry.telemetryLevel": "off"
}
EOF

Обновление VS Code

Обновление APT-версии

sudo apt update
sudo apt install --only-upgrade code

Обновление Insiders-версии

sudo apt update
sudo apt install --only-upgrade code-insiders

Обновление Flatpak-версии

flatpak update com.visualstudio.code

💡 Примечание: Если вы уверены, что хотите обновить без вопросов, можете добавить флаг -y.

Удаление VS Code

Удаление пакета

Для APT-версии (Microsoft репозиторий):

sudo apt remove --purge code code-insiders

Для APT-версии (extrepo):

sudo apt remove --purge code

Для Flatpak-версии:

flatpak uninstall com.visualstudio.code
flatpak uninstall --unused

Удаление репозитория и ключа

Для Microsoft репозитория:

sudo rm -f /etc/apt/sources.list.d/vscode.sources

# Удаление ключа (только если уверены, что он не нужен для других репозиториев)
sudo rm -f /usr/share/keyrings/microsoft.gpg

sudo apt update
sudo apt autoremove

Для extrepo:

sudo extrepo disable vscode
sudo rm -f /etc/apt/sources.list.d/extrepo_vscode.sources
sudo rm -f /var/lib/extrepo/keys/vscode.asc
sudo apt update
sudo apt autoremove

Очистка пользовательских данных (опционально)

⚠️ Внимание: Эти команды безвозвратно удаляют настройки, расширения и кэш VS Code. Убедитесь, что вы понимаете, что делаете.

Для стабильной версии:

rm -rf ~/.config/Code ~/.vscode ~/.cache/Code ~/.local/share/Code

Для Insiders-версии:

rm -rf ~/.config/Code\ -\ Insiders ~/.vscode-insiders ~/.cache/Code\ -\ Insiders ~/.local/share/Code\ -\ Insiders

Для Flatpak:

rm -rf ~/.var/app/com.visualstudio.code

Решение типичных проблем

8.1 Ошибка: Unable to locate package code

Симптом: sudo apt install code не находит пакет.

Причина: Репозиторий не добавлен или не обновлён.

Пошаговое решение:

cat /etc/apt/sources.list.d/vscode.sources
sudo apt update
apt-cache policy code

Если файл отсутствует — создайте заново (см. Способ 1).

8.2 Ошибка: GPG key error / NO_PUBKEY

Симптом: sudo apt update сообщает об отсутствии ключа.

Пошаговое решение:

sudo rm -f /usr/share/keyrings/microsoft.gpg
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor --yes -o /usr/share/keyrings/microsoft.gpg
sudo apt update

8.3 Ошибка: Архитектура не поддерживается (arm64/armhf)

Симптом: При попытке установки на Raspberry Pi пакет не находится.

Причина: В старой конфигурации репозитория была указана только amd64.

Пошаговое решение:

Убедитесь, что в файле репозитория указана правильная архитектура:

cat /etc/apt/sources.list.d/vscode.sources | grep Architectures

Должно быть: Architectures: arm64 (или armhf). Если нет — пересоздайте файл репозитория по инструкции из Способа 1.

8.4 Ошибка: «None of the license inclusion policies» (extrepo)

Симптом: sudo extrepo enable vscode не работает.

Решение: Проверьте, включена ли политика non-free в /etc/extrepo/config.yaml (см. Шаг 2 Способа 2).

8.5 Проблемы с расширениями в Flatpak-версии

Симптом: Некоторые расширения (Remote-SSH, отладчики) не работают.

Причина: Flatpak изолирует приложение.

Решение: Используйте APT-версию VS Code (Microsoft репозиторий) для полной совместимости с расширениями.

Чек-лист: что проверить после установки

  • [ ] VS Code установлен: code --version показывает версию
  • [ ] Программа запускается из терминала (code)
  • [ ] Приложение открывается двойным кликом из меню
  • [ ] Можно открыть папку проекта: code /путь/к/папке
  • [ ] Расширения устанавливаются: откройте Extensions (Ctrl+Shift+X) и попробуйте поставить любое
  • [ ] В apt нет ошибок: sudo apt update завершается без ошибок и предупреждений о ключах

Часто задаваемые вопросы (FAQ)

Вопрос: Какой способ установки VS Code лучше?
Ответ: Microsoft APT репозиторий — стандартный способ, полная совместимость с расширениями. Flatpak — изоляция, удобно, если не хотите засорять систему. extrepo — если вы уже используете этот инструмент.

Вопрос: Можно ли установить VS Code на Raspberry Pi?
Ответ: Да, VS Code официально поддерживает arm64 и armhf. Используйте Способ 1 (Microsoft APT репозиторий).

Вопрос: Почему не работают расширения в Flatpak-версии?
Ответ: Некоторые расширения (Remote-SSH, отладчики) требуют доступа к системе, который ограничен в Flatpak. Используйте APT-версию.

Вопрос: Как обновить VS Code до последней версии?
Ответ: Для APT-версии: sudo apt update && sudo apt install --only-upgrade code. Для Flatpak: flatpak update com.visualstudio.code.

Вопрос: В чём разница между code и code-insiders?
Ответ: code — стабильная версия. code-insiders — ежедневные сборки с новыми функциями, но менее стабильные.

Вопрос: У меня команда code не работает, но пакет установлен. Что делать?
Ответ: Проверьте, как называется исполняемый файл: dpkg -L code | grep bin/. Иногда он лежит как /usr/bin/code, а иногда в редких сборках имя может отличаться. Если ничего не помогает, попробуйте запустить через полный путь: /usr/bin/code.

Заключение

Теперь Visual Studio Code установлен на вашем Debian. Вы можете пользоваться современным редактором кода с поддержкой Git, отладки и тысяч расширений.

Связанные статьи:

Установка Flatpak на Debian

Как добавить пользователя в sudoers в Debian 13, 12, 11: полное руководство

Что дальше?

  • Установите Git для контроля версий
  • Настройте SSH для удалённой разработки
  • Установите расширения для вашего языка программирования (Python, JavaScript, PHP, Go)

Связанные записи