Visual Studio Code (VS Code) — это легковесный, но мощный редактор исходного кода, который поддерживает отладку, встроенный Git, подсветку синтаксиса, интеллектуальное автодополнение кода и обширную библиотеку расширений. VS Code подходит для веб-разработки на JavaScript, написания скриптов на Python, создания бэкендов на PHP и управления Docker-контейнерами.
💡 В этом руководстве мы установим VS Code тремя способами: через утилиту extrepo (рекомендуется), через официальный APT-репозиторий Microsoft и через Flatpak. Все методы обеспечивают автоматические обновления.
В этой статье вы узнаете:
- Как установить VS Code через
extrepo(проще всего) - Как установить VS Code из официального репозитория Microsoft
- Как установить VS Code через Flatpak (песочница)
- Как запускать VS Code из терминала и меню приложений
- Как обновлять и удалять редактор
- Как решить типичные проблемы (GPG-ключи, репозиторий не найден)
Для кого: разработчики (фронтенд, бэкенд, Python, PHP), системные администраторы, пользователи Debian 11, 12 и 13 (поддержка amd64 и arm64).
1. 🔧 Предварительные требования
Перед установкой убедитесь, что:
- У вас установлена Debian 11, 12 или 13 (64-bit)
- Подключение к интернету стабильно
- У вас есть хотя бы 500 МБ свободного места
⚠️ ВАЖНО: Проверьте права sudo перед установкой
Если вы не уверены, есть ли у вашего пользователя права администратора, выполните в терминале:
sudo whoami✅ Если выводит root — всё в порядке, можете продолжать.
❌ Если выводит is not in the sudoers file — сначала пройдите наше руководство по настройке sudo
Обновление системы
Перед установкой всегда обновляйте список пакетов:
sudo apt update && sudo apt upgrade -yЧто делает:
sudo— права суперпользователяapt update— обновляет список доступных пакетов&&— выполняет следующую команду только если предыдущая успешнаapt upgrade -y— обновляет все установленные пакеты,-yавтоматически подтверждает
Зачем: Это стандартная практика безопасности перед установкой нового ПО.
Установка вспомогательных пакетов
sudo apt install curl gpg ca-certificates -yЧто делает:
curl— утилита для скачивания файловgpg— инструмент для работы с цифровыми подписямиca-certificates— пакет с корневыми сертификатами для проверки HTTPS
Зачем: Эти пакеты нужны для безопасного скачивания и импорта GPG-ключа Microsoft.
2. 📊 Сравнение способов установки
| Метод | Источник | Обновления | Для кого |
|---|---|---|---|
extrepo (рекомендуемый) | Debian extrepo | Автоматические через apt upgrade | Большинство пользователей, автоматическое управление GPG-ключами |
| Microsoft APT репозиторий | Официальный репозиторий | Автоматические через apt upgrade | Пользователи, которые хотят прямой контроль над репозиторием |
| Flatpak | Flathub | Автоматические через flatpak update | Пользователи, которые предпочитают песочницу |
💡 Рекомендация: Для большинства пользователей подойдёт метод extrepo — он проще всего настраивается и использует проверенные определения репозиториев от Debian.
3. 🚀 Способ 1: Установка через extrepo (рекомендуемый)
Утилита extrepo — официальный инструмент Debian для управления сторонними репозиториями. Она сама скачивает и обновляет GPG-ключи.
3.1 Установка extrepo
sudo apt install extrepo -yЧто делает: Устанавливает пакет extrepo из официальных репозиториев Debian.
3.2 Включение политики non-free
VS Code содержит проприетарные компоненты Microsoft, поэтому нужно разрешить extrepo работать с non-free репозиториями:
sudo sed -i 's/# - non-free/- non-free/' /etc/extrepo/config.yamlЧто делает: Раскомментирует строку - non-free в конфигурационном файле extrepo.
Зачем: Без этого extrepo откажется добавлять репозиторий VS Code.
3.3 Добавление репозитория VS Code
sudo extrepo enable vscode
sudo apt updateЧто делает: Активирует репозиторий VS Code через extrepo и обновляет список пакетов.
3.4 Проверка репозитория
apt-cache policy code✅ Ожидаемый вывод в терминале:
code:
Installed: (none)
Candidate: 1.97.0-1738712383
Version table:
1.97.0-1738712383 500
500 https://packages.microsoft.com/repos/code stable/main amd64 Packages3.5 Установка VS Code
sudo apt install code -yЧто делает: Устанавливает стабильную версию VS Code.
4. 📦 Способ 2: Установка из официального репозитория Microsoft
Этот метод даёт прямой контроль над репозиторием и работает одинаково на Debian 11, 12 и 13.
4.1 Импорт GPG-ключа Microsoft
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/vscode.gpgЧто делает:
curl -fsSL— скачивает GPG-ключ Microsoftgpg --dearmor— преобразует ключ из текстового формата в бинарный-o /usr/share/keyrings/vscode.gpg— сохраняет ключ в стандартную директорию
4.2 Создание конфигурации репозитория
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: amd64 arm64 armhf
Signed-By: /usr/share/keyrings/vscode.gpg
EOFЧто делает: Создаёт файл репозитория в современном формате DEB822 с поддержкой нескольких архитектур (amd64, arm64, armhf).
Зачем: Формат .sources является современным стандартом Debian и обеспечивает явную привязку ключа к репозиторию.
4.3 Обновление списка пакетов и установка
sudo apt update
sudo apt install code -y4.4 Установка Insiders-версии (опционально)
Если вы хотите получать ежедневные обновления с новейшими функциями:
sudo apt install code-insiders -yЧто делает: Устанавливает Insiders-сборку VS Code (обновляется ежедневно).
⚠️ Внимание: Insiders-версия может быть менее стабильной. Используйте её для ознакомления с новыми функциями.
5. 📦 Способ 3: Установка через Flatpak
Flatpak устанавливает VS Code в изолированную среду (песочницу) с автоматическими обновлениями через Flathub.
⚠️ Перед установкой: Убедитесь, что Flatpak установлен. Если нет — пройдите наше руководство по установке Flatpak на Debian.
5.1 Добавление репозитория Flathub
sudo flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo5.2 Установка VS Code
sudo flatpak install flathub com.visualstudio.code -yЧто делает: Устанавливает VS Code из Flathub.
5.3 Проверка установки
flatpak info com.visualstudio.code✅ Ожидаемый вывод в терминале:
Visual Studio Code - Code editing. Redefined.
ID: com.visualstudio.code
Ref: app/com.visualstudio.code/x86_64/stable
Arch: x86_64
Branch: stable
Origin: flathub
Version: 1.97.06. 🖱️ Запуск Visual Studio Code
6.1 Запуск из терминала
Для APT-установки (extrepo или Microsoft репозиторий):
codeДля Insiders-версии:
code-insidersДля Flatpak:
flatpak run com.visualstudio.codeОткрыть конкретный проект:
code /путь/к/проекту6.2 Запуск из меню приложений
Нажмите Super (клавиша с логотипом Windows) или кликните «Activities», введите в поиске «Visual Studio Code» или «Code» и нажмите на иконку.
7. 🔄 Обновление Visual Studio Code
7.1 Обновление через APT (extrepo или Microsoft репозиторий)
sudo apt update && sudo apt upgrade -yИли обновить только VS Code:
sudo apt update && sudo apt install --only-upgrade code -y7.2 Обновление через Flatpak
sudo flatpak update com.visualstudio.code8. ❌ Удаление Visual Studio Code
8.1 Удаление APT-версии (extrepo)
sudo apt remove code -y
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 -y8.2 Удаление APT-версии (Microsoft репозиторий)
sudo apt remove code code-insiders -y
sudo rm -f /etc/apt/sources.list.d/vscode.sources
sudo rm -f /usr/share/keyrings/vscode.gpg
sudo apt update
sudo apt autoremove -y8.3 Удаление Flatpak-версии
sudo flatpak uninstall com.visualstudio.code -y
sudo flatpak uninstall --unused -y8.4 Удаление пользовательских данных
⚠️ Внимание: Следующие команды безвозвратно удаляют ваши настройки, расширения, сниппеты и кэш 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.code9. ⚠️ Решение типичных проблем
9.1 Ошибка GPG-ключа (NO_PUBKEY)
Симптом: apt update сообщает об отсутствии публичного ключа.
Решение: Переустановите GPG-ключ:
sudo rm -f /usr/share/keyrings/vscode.gpg
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/vscode.gpg
sudo apt update9.2 Ошибка «Unable to locate package code»
Симптом: APT не находит пакет code.
Причина: Репозиторий не добавлен или не обновлён.
Решение: Проверьте, что файл репозитория существует:
cat /etc/apt/sources.list.d/vscode.sourcesЕсли файл отсутствует или пуст — создайте заново (раздел 4.2). Затем выполните sudo apt update.
9.3 Ошибка «None of the license inclusion policies in vscode were enabled» (extrepo)
Симптом: При sudo extrepo enable vscode появляется сообщение о политиках лицензий.
Причина: Non-free политика не включена в конфигурации extrepo.
Решение: Включите non-free политику:
sudo sed -i 's/# - non-free/- non-free/' /etc/extrepo/config.yaml
sudo extrepo enable vscode9.4 VS Code не запускается на ARM-устройствах (Raspberry Pi)
Симптом: При попытке установить VS Code на Raspberry Pi (arm64) пакет не находится.
Причина: В старой конфигурации репозитория была указана только архитектура amd64.
Решение: В современной конфигурации (раздел 4.2) уже указаны Architectures: amd64 arm64 armhf. Если у вас старая конфигурация — пересоздайте файл репозитория по инструкции.
9.5 Проблемы с расширениями в Flatpak-версии
Симптом: Некоторые расширения (например, Remote-SSH) не работают в Flatpak-версии.
Причина: Flatpak изолирует приложение, ограничивая доступ к системе.
Решение: Используйте APT-версию VS Code (extrepo или Microsoft репозиторий) для полной совместимости с расширениями.
10. 📝 Чек-лист: всё готово к работе
- [ ] VS Code установлен:
code --versionпоказывает версию - [ ] Программа запускается из меню приложений
- [ ] Программа запускается из терминала командой
code - [ ] Можете открыть существующий проект или создать новый файл
- [ ] Расширения устанавливаются (проверьте через Ctrl+Shift+X)
- [ ]
sudo apt updateзавершается без ошибок
Заключение
Вы успешно установили Visual Studio Code на Debian. Теперь у вас есть современный редактор кода с поддержкой Git, отладки и тысяч расширений. Благодаря APT-репозиторию (через extrepo или Microsoft) VS Code будет обновляться вместе с системой.
Что дальше:
- Настройте VS Code под себя: выберите тему, настройте сочетания клавиш
- Установите расширения для вашего языка программирования (Python, JavaScript, PHP, Go)
- Изучите официальную документацию VS Code
- Для работы с удалёнными серверами настройте SSH на Debian и используйте расширение Remote-SSH
