Visual Studio Code (VS Code) — это легковесный, но мощный редактор исходного кода, который поддерживает отладку, встроенный Git, подсветку синтаксиса, интеллектуальное автодополнение и обширную библиотеку расширений. VS Code подходит для веб-разработки на JavaScript, написания скриптов на Python, создания бэкендов на PHP и управления Docker-контейнерами.
В этом обновлённом руководстве я покажу три способа установки VS Code на Debian:
- extrepo (рекомендуемый) — автоматическое управление репозиторием
- Microsoft APT репозиторий — с поддержкой amd64, arm64, armhf
- Flatpak — изолированная установка (песочница)
| Метод | Архитектуры | Обновления | Для кого |
|---|---|---|---|
| extrepo | amd64 | Через apt upgrade | Большинство пользователей |
| Microsoft APT | amd64, arm64, armhf | Через apt upgrade | Пользователи Raspberry Pi и ARM-устройств |
| Flatpak | x86_64, aarch64 | Через flatpak update | Те, кто предпочитает песочницу |
⚠️ Важно: VS Code официально поддерживает amd64, arm64, armhf. Если ваша архитектура не входит в этот список — используйте браузерную версию.
Предварительные требования
Перед установкой убедитесь, что:
- У вас установлена Debian 11, 12 или 13
- Вы имеете права
sudo(администратора)
⚠️ ВАЖНО: Проверьте права sudo перед установкой
sudo whoami✅ Ожидаемый вывод: root
❌ Если выводит is not in the sudoers file — сначала пройдите наше руководство по настройке sudo.
Обновление системы
sudo apt update && sudo apt upgrade -yУстановка вспомогательных пакетов
sudo apt install -y curl gpg ca-certificatesСпособ 1: Установка через extrepo (рекомендуемый)
Шаг 1: Установите extrepo
sudo apt install -y extrepoШаг 2: Включите политику non-free
sudo sed -i 's/# - non-free/- non-free/' /etc/extrepo/config.yamlШаг 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 -y codeСпособ 2: Установка из официального репозитория Microsoft (с поддержкой ARM)
Этот метод подходит для любых архитектур, поддерживаемых 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Шаг 3: Добавьте репозиторий (с проверкой архитектуры)
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 "Ваша архитектура ($ARCH) не поддерживается VS Code."
echo "Используйте браузерную версию или Flatpak."
exit 1
;;
esacШаг 4: Обновите список пакетов и установите VS Code
sudo apt update
sudo apt install -y codeШаг 5: Установка Insiders-версии (опционально)
sudo apt install -y code-insidersСпособ 3: Установка через Flatpak
Шаг 1: Установите Flatpak (если не установлен)
sudo apt install -y flatpak
sudo flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepoШаг 2: Установите VS Code
sudo flatpak install flathub com.visualstudio.code -yШаг 3: Проверьте установку
flatpak info com.visualstudio.code✅ Ожидаемый вывод: ID: com.visualstudio.code, Version: 1.x.x
Запуск Visual Studio Code
| Метод | Команда запуска |
|---|---|
| APT (extrepo или Microsoft) | code |
| Insiders-версия | code-insiders |
| Flatpak | flatpak run com.visualstudio.code |
Обновление VS Code
Обновление APT-версии
sudo apt update && sudo apt install --only-upgrade code -yОбновление Insiders-версии
sudo apt update && sudo apt install --only-upgrade code-insiders -yОбновление Flatpak-версии
sudo flatpak update com.visualstudio.codeУдаление VS Code
Удаление APT-версии (extrepo)
sudo apt remove --purge code
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 -yУдаление APT-версии (Microsoft репозиторий)
sudo apt remove --purge code code-insiders
sudo rm -f /etc/apt/sources.list.d/vscode.sources
# Безопасное удаление ключа (только если не используется другими репозиториями)
for keyring in /usr/share/keyrings/microsoft.gpg; do
if [ -f "$keyring" ]; then
if ! grep -r -l "$keyring" /etc/apt/sources.list.d/ 2>/dev/null; then
sudo rm -f "$keyring"
else
echo "Ключ $keyring используется другими репозиториями, не удалён."
fi
fi
done
sudo apt update
sudo apt autoremove -yУдаление Flatpak-версии
sudo flatpak uninstall com.visualstudio.code -y
sudo flatpak uninstall --unused -yУдаление пользовательских данных
# Для стабильной версии
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Если файл отсутствует — создайте заново (см. Способ 2).
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 update8.3 Ошибка: Архитектура не поддерживается (arm64/armhf)
Симптом: При попытке установки на Raspberry Pi пакет не находится.
Причина: В старой конфигурации репозитория была указана только amd64.
Пошаговое решение:
Убедитесь, что в файле репозитория указана правильная архитектура:
cat /etc/apt/sources.list.d/vscode.sources | grep ArchitecturesДолжно быть: Architectures: arm64 (или armhf). Если нет — пересоздайте файл репозитория по инструкции из Способа 2.
8.4 Ошибка: «None of the license inclusion policies» (extrepo)
Симптом: sudo extrepo enable vscode не работает.
Пошаговое решение:
sudo sed -i 's/# - non-free/- non-free/' /etc/extrepo/config.yaml
sudo extrepo enable vscode8.5 Проблемы с расширениями в Flatpak-версии
Симптом: Некоторые расширения (Remote-SSH, отладчики) не работают.
Причина: Flatpak изолирует приложение.
Пошаговое решение:
Используйте APT-версию VS Code (extrepo или Microsoft репозиторий) для полной совместимости с расширениями.
Чек-лист: что проверить после установки
- [ ] VS Code установлен:
code --versionпоказывает версию - [ ] Программа запускается из меню приложений
- [ ] Программа запускается из терминала (
code) - [ ] Можно открыть существующий проект или создать новый файл
- [ ] Расширения устанавливаются (
Ctrl+Shift+X) - [ ]
sudo apt updateпроходит без ошибок
Заключение
Теперь Visual Studio Code установлен на вашем Debian. Вы можете пользоваться современным редактором кода с поддержкой Git, отладки и тысяч расширений.
Что дальше?
