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

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

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

⚠️ Важное примечание: Ручное добавление репозитория должно использовать официальный источник https://repo.vscodium.dev/deb. Устаревший репозиторий paulcarroty.gitlab.io больше не рекомендуется к использованию.

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

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

Для кого: разработчики, системные администраторы, а также все, кто ищет редактор кода без телеметрии на 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. Вот их сравнение:

МетодКаналВерсияОбновленияПлюсыМинусы
Официальный
APT-
репозиторий
(рекомендован
ный)		repo.vscodium.devПоследняя
стабильная		Автоматически
через
apt upgrade		Полный
контроль,
официальный
источник		Требует
ручного
добавления
ключа
FlatpakFlathubПоследняя
стабильная		Автоматически
через
flatpak update		Изоляция,
чистое
удаление		Требует
установки
Flatpak, нужна
настройка
доступа к
файлам
extrepoDebian Extrepo
(может указывать
на старый
репозиторий)		Последняя
стабильная		Автоматически
через
apt upgrade		Минимум
команд		Требует
проверки
источника,
не рекомендуется
для новых
установок

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

3. 📦 Способ 1: Установка VSCodium из официального APT-репозитория (рекомендованный)

Этот способ даёт вам самый свежий VSCodium напрямую от разработчиков. Вы получаете автоматические обновления через apt upgrade.

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

sudo apt install ca-certificates curl gpg -y

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

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

curl -fsSL https://repo.vscodium.dev/vscodium.gpg | sudo gpg --dearmor --yes -o /usr/share/keyrings/vscodium.gpg

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

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

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

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

3.4 Проверка файла репозитория

cat /etc/apt/sources.list.d/vscodium.sources

✅ Ожидаемый вывод:

Types: deb
URIs: https://repo.vscodium.dev/deb
Suites: vscodium
Components: main
Architectures: amd64 arm64 armhf
Signed-By: /usr/share/keyrings/vscodium.gpg

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

sudo apt update
sudo apt install codium -y

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

💡 Примечание про socat: VSCodium может установить пакет socat как зависимость. Он нужен для некоторых функций интеграции с терминалом. Если вы не используете эти функции, socat можно удалить через sudo apt autoremove — но только после того, как убедитесь, что он не нужен другим программам.

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

Проверка версии:

codium --version

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

1.96.4
221e0a382c0be3a673a4e4cab0601344a0b3de3a
x64

(Версия и хеш коммита будут актуальными на момент установки.)

Проверка статуса пакета:

dpkg-query -W -f='${db:Status-Abbrev} ${binary:Package} ${Version} ${Architecture}\n' codium

✅ Ожидаемый вывод:

ii codium 1.96.4 amd64

ii означает «installed ok installed» — пакет установлен корректно.

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

Flatpak устанавливает VSCodium в изолированную среду. Этот способ подходит, если вы предпочитаете Flatpak другим методам установки.

4.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.

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

sudo flatpak install flathub com.vscodium.codium -y

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

flatpak info com.vscodium.codium | grep -E '^(ID|Version|Origin)'

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

ID: com.vscodium.codium
Version: 1.96.4
Origin: flathub

4.4 Запуск

flatpak run com.vscodium.codium

4.5 Настройка доступа к файлам (если нужно)

Flatpak по умолчанию видит только домашнюю директорию. Если ваши проекты лежат на другом диске (например, /mnt/projects), добавьте доступ:

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

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

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

5. 📦 Способ 3: Установка VSCodium через extrepo (только для существующих установок)

⚠️ Важное примечание: Extrepo в Debian может указывать на устаревший репозиторий paulcarroty. Используйте этот способ только если вы уже работаете с extrepo и готовы проверить источник. Для новых установок рекомендуется Способ 1.

5.1 Установка extrepo

sudo apt update
sudo apt install extrepo -y

5.2 Проверка, какой репозиторий будет добавлен

extrepo search vscodium

Что ищем: В выводе должна быть строка URIs — убедитесь, что это официальный репозиторий repo.vscodium.dev. Если видите paulcarroty.gitlab.io — не используйте этот способ, перейдите к Способу 1.

5.3 Включение репозитория и установка (только если источник правильный)

sudo extrepo enable vscodium
sudo apt update
sudo apt install codium -y

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

codium --version
dpkg-query -W -f='${db:Status-Abbrev} ${binary:Package} ${Version} ${Architecture}\n' codium

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

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

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

codium

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

flatpak run com.vscodium.codium

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

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

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

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

Пример:

mkdir -p ~/Projects/vscodium-demo
printf '# VSCodium on Debian\n' > ~/Projects/vscodium-demo/README.md
codium ~/Projects/vscodium-demo

6.4 ⚠️ Важное предупреждение: не запускайте VSCodium от root

Никогда не запускайте VSCodium с sudo codium. Это может привести к тому, что файлы настроек в вашей домашней директории станут принадлежать root, и редактор перестанет нормально работать.

Если вам нужно отредактировать системный файл (например, в /etc):

  • Используйте терминал с sudo внутри VSCodium (Ctrl+ — открыть терминал, затемsudo nano /etc/файл`)
  • Или скопируйте файл в домашнюю директорию, отредактируйте его, а затем скопируйте обратно с помощью sudo

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

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

Как установить расширение:

  • Откройте VSCodium
  • Нажмите на иконку расширений (четыре квадратика) слева
  • Ищите нужное расширение
  • Нажмите «Install»

Если расширение не найдено, проверьте его доступность на open-vsx.org.

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

Для APT-версии

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-ключ повреждён, устарел или используется старый репозиторий.

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

Шаг 1: Скачайте ключ заново:

curl -fsSL https://repo.vscodium.dev/vscodium.gpg | sudo gpg --dearmor --yes -o /usr/share/keyrings/vscodium.gpg

Шаг 2: Проверьте, что файл репозитория указывает на repo.vscodium.dev:

cat /etc/apt/sources.list.d/vscodium.sources

Шаг 3: Обновите списки пакетов:

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) и разные конфигурационные директории (~/.config/VSCodium vs ~/.config/Code). Конфликтов быть не должно.

Проверка:

which codium
which code

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

8.5 VSCodium не запускается на рабочем столе

Симптом: VSCodium установлен, команда в терминале работает, но из меню не запускается.

Причина: Возможно, проблема с кэшем меню или с окружением рабочего стола.

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

Шаг 1: Запустите VSCodium из терминала, чтобы увидеть ошибку:

codium

Шаг 2: Если ошибка связана с графикой, попробуйте отключить аппаратное ускорение при запуске:

codium --disable-gpu

Шаг 3: Если терминальный запуск работает, а иконка в меню нет — выйдите из системы и зайдите снова.

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

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

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.gpg
sudo apt update

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

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

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

⚠️ Осторожно: Удаляет все настройки, расширения и кэш VSCodium. Сделайте резервную копию, если нужно сохранить настройки.

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

rm -rf ~/.config/VSCodium
rm -rf ~/.vscode-oss
rm -rf ~/.cache/VSCodium

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

rm -rf ~/.var/app/com.vscodium.codium

Проверка удаления

command -v codium

✅ Ожидаемый вывод: Пустая строка (если VSCodium больше не установлен).

10. 📝 Чек-лист: всё готово к работе

  • [ ] Система обновлена (sudo apt update && sudo apt upgrade -y)
  • [ ] Выбран и выполнен один из способов установки (официальный APT / Flatpak / extrepo)
  • [ ] codium --version показывает версию
  • [ ] dpkg-query -W -f='...' codium показывает ii в начале строки
  • [ ] VSCodium запускается из меню приложений или терминала
  • [ ] (Для Flatpak) Настроен доступ к нужным директориям
  • [ ] Расширения устанавливаются через встроенный маркетплейс (Open VSX)

Заключение

Вы установили VSCodium на Debian. Если вы выбрали официальный APT-репозиторий — получили самый свежий VSCodium напрямую от разработчиков с полным контролем. Если выбрали Flatpak — получили изолированную среду. VSCodium — это отличная альтернатива Visual Studio Code без телеметрии, с тем же функционалом и поддержкой большинства расширений через Open VSX Registry.

Что дальше:

  • Установите расширения: Python, JavaScript/TypeScript, GitLens, Docker, Prettier
  • Настройте синхронизацию настроек через Settings Sync (расширение) или вручную через копирование ~/.config/VSCodium
  • Настройте VSCodium как редактор по умолчанию для Git: git config --global core.editor "codium --wait"
  • Изучите сочетания клавиш: Ctrl+Shift+P — палитра команд, Ctrl+P — быстрый переход к файлу, `Ctrl+« — встроенный терминал

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

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