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

VSCodium — это редактор кода, полностью совместимый с Visual Studio Code, но без телеметрии Microsoft и с открытой лицензией. Он даёт вам тот же интерфейс, те же расширения (через Open VSX Registry) и те же возможности: IntelliSense, встроенную отладку, поддержку Git и интеграцию с терминалом. Главные сложности при установке на Debian: нужно добавить репозиторий (через extrepo или вручную) и правильно импортировать GPG-ключ. extrepo — самый простой способ, он сам скачивает ключи и создаёт конфигурацию. Если вы предпочитаете полный контроль — можно добавить репозиторий вручную. Flatpak-версия тоже доступна, но требует настройки доступа к файлам.

💡 В этом руководстве вы установите VSCodium на Debian тремя способами: через extrepo (рекомендованный), через ручное добавление APT-репозитория и через Flatpak. Вы также узнаете, как запускать редактор, обновлять, удалять и решать типичные проблемы.

В этой статье вы узнаете:

Как установить VSCodium через extrepo (рекомендованный способ)
Как установить VSCodium через ручное добавление APT-репозитория
Как установить VSCodium через Flatpak
Как запускать и обновлять VSCodium
Как решить типичные проблемы: ошибки GPG-ключа, пустой marketplace, конфликты с VS Code

Для кого: разработчики, системные администраторы, а также все, кто ищет редактор кода без телеметрии на Debian 11, 12 или 13.

Оглавление

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

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

У вас установлена Debian 11, 12 или 13
Подключение к интернету стабильно
У вас есть права sudo

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

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

sudo whoami

Что делает: sudo выполняет команду от имени суперпользователя, whoami показывает имя текущего пользователя.

Зачем: Эта команда проверяет, есть ли у вас права sudo. Без них вы не сможете устанавливать пакеты.

✅ Если выводит root — всё в порядке, можете продолжать.

❌ Если выводит is not in the sudoers file — сначала пройдите наше руководство по настройке sudo.

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

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

sudo apt update && sudo apt upgrade -y

Что делает:

sudo — права суперпользователя
apt update — обновляет список доступных пакетов из репозиториев
&& — выполняет следующую команду только если предыдущая успешна
apt upgrade -y — обновляет все установленные пакеты до последних версий

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

2. 📊 Сравнение способов установки VSCodium

В Debian есть три основных способа установки VSCodium. Вот их сравнение:

Метод	Канал	Версия	Обновления	Плюсы	Минусы
extrepo рекомендовано	Репозиторий VSCodium (через extrepo)	Последняя стабильная	Автоматически через `apt upgrade`	Минимум команд, автоматическое управление ключами	Меньше контроля
APT- репозиторий (ручной)	Репозиторий VSCodium	Последняя стабильная	Автоматически через `apt upgrade`	Полный контроль над конфигурацией	Больше шагов, нужно вручную импортировать ключ
Flatpak	Flathub	Последняя стабильная	Автоматически через `flatpak update`	Изоляция, чистое удаление	Требует установки Flatpak, может потребоваться настройка доступа к файлам

💡 Рекомендация: Для большинства пользователей подойдёт extrepo. Это официальный инструмент Debian для управления сторонними репозиториями, он сам скачивает ключи и создаёт файлы. Ручной способ выбирайте, если вам нужен точный контроль или вы пишете скрипты. Flatpak подходит для тех, кто предпочитает изолированные приложения.

3. 📦 Способ 1: Установка VSCodium через extrepo (рекомендованный)

extrepo — это инструмент от Debian, который упрощает добавление сторонних репозиториев. Он сам скачивает GPG-ключи и создаёт файлы репозиториев.

3.1 Установка extrepo

sudo apt install extrepo -y

Что делает: Устанавливает утилиту extrepo для управления сторонними репозиториями.

3.2 Включение репозитория VSCodium

sudo extrepo enable vscodium

Что делает: Добавляет репозиторий VSCodium в источники APT и импортирует GPG-ключ.

3.3 Обновление списка пакетов и установка

sudo apt update
sudo apt install codium -y

Что делает: Обновляет списки пакетов (теперь с учётом репозитория VSCodium) и устанавливает VSCodium.

3.4 Проверка установки

codium --version

✅ Ожидаемый вывод в терминале:

1.96.x
xxxxxxxxx
x64

4. 📦 Способ 2: Установка VSCodium через ручное добавление APT-репозитория

Этот способ подходит, если вы хотите полностью контролировать процесс или использовать в скриптах.

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

sudo apt install curl gpg -y

Что делает: Устанавливает curl для скачивания и gpg для работы с ключами.

4.2 Импорт GPG-ключа VSCodium

curl -fsSL https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/master/pub.gpg | sudo gpg --dearmor --yes -o /usr/share/keyrings/vscodium-archive-keyring.gpg

Что делает: Скачивает GPG-ключ репозитория VSCodium и сохраняет его в бинарном формате в стандартную директорию для ключей.

4.3 Создание файла репозитория (современный формат DEB822)

sudo tee /etc/apt/sources.list.d/vscodium.sources > /dev/null <<EOF
Types: deb
URIs: https://paulcarroty.gitlab.io/vscodium-deb-rpm-repo/debs
Suites: vscodium
Components: main
Architectures: amd64 arm64
Signed-By: /usr/share/keyrings/vscodium-archive-keyring.gpg
EOF

Что делает: Создаёт файл репозитория в современном формате DEB822.

4.4 Обновление списка пакетов и установка

sudo apt update
sudo apt install codium -y

4.5 Проверка установки

codium --version

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

Flatpak устанавливает VSCodium в изолированную среду.

5.1 Установка Flatpak (если ещё не установлен)

sudo apt install flatpak -y
sudo flatpak remote-add --system --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

Что делает: Устанавливает Flatpak и добавляет репозиторий Flathub.

💡 Если вы не знакомы с Flatpak: У нас есть подробное руководство по установке Flatpak на Debian.

5.2 Установка VSCodium из Flathub

sudo flatpak install flathub com.vscodium.codium -y

5.3 Проверка установки

flatpak info com.vscodium.codium

✅ Ожидаемый вывод в терминале (сокращённо):

VSCodium - Code Editing. Redefined.

          ID: com.vscodium.codium
     Version: 1.96.x

5.4 Запуск (Flatpak)

flatpak run com.vscodium.codium

6. 🖥️ Запуск и использование VSCodium

6.1 Запуск из терминала

Для APT/extrepo:

codium

Для Flatpak:

flatpak run com.vscodium.codium

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

Нажмите Super (клавиша с логотипом Windows), введите VSCodium, нажмите на иконку.

6.3 Открытие проекта

codium /путь/к/проекту

6.4 Важное примечание о расширениях

VSCodium использует Open VSX Registry для расширений, а не Microsoft Marketplace. Большинство популярных расширений доступны, но некоторые специфические (Remote SSH, Live Share, Pylance) могут отсутствовать. Для них есть инструкции по подключению Microsoft Marketplace (неофициально).

7. 🔄 Обновление VSCodium

Для APT/extrepo

sudo apt update
sudo apt install --only-upgrade codium -y

Для Flatpak

sudo flatpak update com.vscodium.codium

8. ⚠️ Решение типичных проблем

8.1 Ошибка GPG-ключа при apt update

Симптом: sudo apt update выдаёт ошибку, связанную с ключом репозитория VSCodium.

Причина: GPG-ключ повреждён или устарел.

Решение: Скачайте ключ заново:

curl -fsSL https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/master/pub.gpg | sudo gpg --dearmor --yes -o /usr/share/keyrings/vscodium-archive-keyring.gpg
sudo apt update

8.2 Маркетплейс расширений пуст или не показывает результаты

Симптом: В VSCodium в разделе расширений ничего не отображается или поиск не работает.

Причина: VSCodium использует Open VSX Registry. Если реестр недоступен, расширения не загружаются.

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

Шаг 1: Проверьте доступность Open VSX:

curl -I https://open-vsx.org/

✅ Ожидаемый вывод: HTTP/2 200

Шаг 2: Если реестр доступен, проверьте настройки VSCodium: File → Preferences → Settings → поиск extensions → убедитесь, что не задан кастомный marketplace.

8.3 Flatpak: VSCodium не видит файлы за пределами домашней директории

Симптом: VSCodium, установленный через Flatpak, не может открыть файлы на другом диске (например, /mnt/projects).

Причина: Flatpak изолирует приложения. По умолчанию VSCodium видит только домашнюю папку.

Решение: Добавьте доступ к нужной директории:

sudo flatpak override com.vscodium.codium --filesystem=/путь/к/директории

Пример для доступа к /mnt/projects:

sudo flatpak override com.vscodium.codium --filesystem=/mnt/projects

8.4 Конфликт между VSCodium и VS Code

Симптом: VSCodium и VS Code установлены одновременно, и они мешают друг другу.

Причина: Они используют разные бинарные файлы (codium vs code) и разные конфигурационные директории. Конфликтов быть не должно.

Проверка:

which codium
which code

Если оба установлены, они работают независимо.

9. ❌ Удаление VSCodium

Удаление APT/extrepo-версии

sudo apt remove codium -y
sudo apt autoremove -y

Удаление репозитория (для ручного способа):

sudo rm -f /etc/apt/sources.list.d/vscodium.sources
sudo rm -f /usr/share/keyrings/vscodium-archive-keyring.gpg

Удаление репозитория (для extrepo):

sudo extrepo disable vscodium
sudo rm -f /etc/apt/sources.list.d/extrepo_vscodium.sources

Удаление Flatpak-версии

sudo flatpak uninstall com.vscodium.codium -y
sudo flatpak uninstall --unused -y

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

⚠️ Осторожно: Удаляет все настройки, расширения и кэш VSCodium.