После установки Sublime Text 4 и открытия первого файла с расширением .py редактор подсвечивает синтаксис, но не запускает код и не подсказывает ошибки — это нормальное поведение, потому что поддержка Python «из коробки» ограничена базовой подсветкой и простой системой сборки. Чтобы превратить редактор в полноценную среду разработки, нужно вручную подключить несколько компонентов: пакетный менеджер, языковой сервер и конфигурацию запуска.
В этой статье разберём настройку Sublime Text 4 для работы с Python шаг за шагом: от установки Package Control до автодополнения, проверки кода линтером и запуска скриптов комбинацией клавиш. Все шаги актуальны для Windows, macOS и Linux — различия будут оговорены отдельно.
Установка Package Control — основа всех расширений
Первое действие после установки редактора — подключить Package Control, без которого установка плагинов невозможна. Откройте консоль редактора через меню View → Show Console и вставьте команду установки, которую нужно взять с официального сайта packagecontrol.io — она периодически меняется, поэтому копировать её лучше именно оттуда, а не из старых инструкций.
Альтернативный способ — меню Tools → Install Package Control, если этот пункт присутствует в вашей версии. После установки перезапустите редактор и проверьте результат: нажмите Ctrl+Shift+P (на macOS — Cmd+Shift+P) и начните вводить Package Control: Install Package. Если команда находится — всё работает.
Автодополнение и подсказки: сервер LSP-pyright
Нативное автодополнение Sublime Text 4 работает на уровне слов из открытых файлов и не понимает структуру Python-кода. Для умных подсказок, перехода к определению функций и подсветки ошибок прямо в редакторе используется протокол LSP (Language Server Protocol) и языковой сервер Pyright от Microsoft.
Установка занимает несколько минут и состоит из двух пакетов:
- 📦
LSP— базовый клиент протокола, ставится черезPackage Control: Install Package; - 🐍
LSP-pyright— привязка сервера Pyright к Python-файлам; - ⚙️ Node.js — требуется для работы Pyright, должен быть установлен в системе заранее;
- 🔄 После установки пакетов откройте любой
.py-файл — сервер запустится автоматически.
После запуска сервера внизу окна, в строке состояния, появится индикатор LSP-pyright. Наведите курсор на любую функцию — появится всплывающая подсказка с типами и документацией. Переход к определению работает через F12 или контекстное меню.
⚠️ Внимание: если LSP-pyright не стартует, чаще всего причина в отсутствующем или слишком старом Node.js. Проверьте его командой
node --versionв терминале системы — при ошибке установите актуальную версию с официального сайта Node.js.
Проверка кода: линтеры SublimeLinter и flake8
Pyright сам умеет сообщать об ошибках типов и неопределённых переменных, но для проверки стиля кода по PEP 8 и поиска типовых проблем принято подключать линтер. Связка SublimeLinter + SublimeLinter-flake8 подчёркивает проблемные строки прямо в редакторе.
Сначала установите сам линтер в систему — он должен лежать в том же окружении Python, которое вы используете для проекта:
pip install flake8Затем через Package Control установите два пакета: SublimeLinter и SublimeLinter-flake8. После перезапуска редактора ошибки и предупреждения начнут отображаться в виде маркеров на полях и подчёркиваний в коде. Список всех проблем открывается через Ctrl+K, A или через контекстное меню SublimeLinter.
Для автоматического форматирования кода дополнительно можно поставить пакет black (через pip install black) и плагин sublack — тогда файл будет приводиться к единому стилю по сохранению или по горячей клавише.
☑️ Чек-лист настройки Python в Sublime Text 4
Запуск Python-скриптов через Build System
За запуск кода в Sublime Text 4 отвечает механизм Build System. Встроенный профиль Python уже есть в редакторе: откройте Tools → Build System → Python и нажмите Ctrl+B (Cmd+B на macOS) — скрипт выполнится, а вывод появится в панели внизу окна.
Проблема возникает, когда в системе несколько версий Python или используется виртуальное окружение: встроенный профиль вызывает интерпретатор по умолчанию. Решение — собственный файл конфигурации. Создайте его через Tools → Build System → New Build System:
{
"cmd": ["python3", "-u", "$file"],
"selector": "source.python",
"file_regex": "^[ ]File \"(...?)\", line ([0-9]*)"
}
Сохраните файл под понятным именем, например Python3-venv.sublime-build, и выберите его в меню Build System. Параметр -u отключает буферизацию вывода — сообщения print() будут появляться сразу, а не после завершения скрипта. Для виртуального окружения вместо python3 укажите полный путь к интерпретатору внутри папки venv.
⚠️ Внимание: встроенная панель вывода Sublime Text не принимает пользовательский ввод. Если скрипт использует
input(), запуск черезCtrl+Bзавершится ошибкой EOFError. Для таких программ запускайте код во внешнем терминале.
Сравнение популярных плагинов для Python
Выбор конкретных пакетов зависит от задач. Ниже — сводная таблица основных решений, о которых шла речь выше.
| Пакет | Назначение | Зависимости |
|---|---|---|
LSP-pyright | Автодополнение, типы, переходы | Node.js, пакет LSP |
SublimeLinter-flake8 | Проверка стиля и ошибок | flake8 в системе |
sublack | Автоформатирование (black) | black в системе |
Terminus | Терминал внутри редактора | Нет |
Anaconda | Альтернатива LSP (на базе Jedi) | Нет |
Обратите внимание: Anaconda (плагин, не путать с дистрибутивом Python) и LSP-pyright конфликтуют — оба перехватывают автодополнение. Устанавливать нужно что-то одно. Для новых проектов предпочтительнее связка на базе LSP: она активнее развивается и лучше работает с аннотациями типов.
Типичные проблемы и их решения
Разберём ситуации, с которыми чаще всего сталкиваются при настройке Sublime Text 4 под Python.
- 🔍 Pyright не видит установленные библиотеки — сервер использует другой интерпретатор, чем ваш проект. Укажите путь к нужному окружению в настройках
LSP-pyrightчерез пунктPreferences → Package Settings → LSP → Servers → LSP-pyright. - 🐌 Редактор тормозит на больших файлах — отключите линтер для файлов свыше определённого размера или проверьте, не запущено ли два языковых сервера одновременно.
- ⌨️ Ctrl+B запускает старую версию Python — выбран не тот Build System; переключите профиль в меню
Tools → Build Systemили создайте собственный с явным путём к интерпретатору. - ❌ Ошибка кодировки в выводе — добавьте в профиль сборки параметр
"env": {"PYTHONIOENCODING": "utf-8"}, чтобы кириллица в выводе отображалась корректно.
Если проблема не решается, полезно заглянуть в лог LSP: команда LSP: Toggle Log Panel в палитре команд показывает обмен сообщениями между редактором и сервером. Там видно, запустился ли Pyright и какие ошибки он вернул.
Как указать виртуальное окружение для LSP-pyright
Откройте настройки сервера через Preferences → Package Settings → LSP → Servers → LSP-pyright. В секции settings добавьте параметр "python.pythonPath" с полным путём к интерпретатору вашего venv. После сохранения перезапустите сервер командой LSP: Restart Servers из палитры команд.
Полезные мелочи для ежедневной работы
Несколько настроек делают работу с Python заметно комфортнее. В файле настроек (Preferences → Settings) для синтаксиса Python можно задать отступы в четыре пробела и автоматическое удаление лишних пробелов в конце строк — это соответствует PEP 8 и избавляет от части предупреждений линтера. Настройки для конкретного типа файлов задаются через Preferences → Settings – Syntax Specific, когда открыт .py-файл.
Из встроенных возможностей особенно полезны множественные курсоры (Ctrl+D для выбора следующего вхождения слова) и Go to Symbol (Ctrl+R) — мгновенный переход к любой функции или классу в текущем файле. Для навигации по проекту целиком используйте Ctrl+P с вводом имени файла.
⚠️ Внимание: не редактируйте файл настроек в левой панели — это значения по умолчанию, которые перезаписываются при обновлении. Все изменения вносите в правую панель (пользовательские настройки), они сохраняются при апдейтах редактора.
Часто задаваемые вопросы
Подходит ли Sublime Text 4 для начинающих в Python?
Да, но с оговоркой: редактор требует ручной настройки, в отличие от PyCharm, где всё работает сразу. Для изучения языка это даже плюс — вы понимаете, как устроены интерпретатор, окружения и запуск кода. Минимальный набор для старта: Package Control, LSP-pyright и настроенный Build System.
Sublime Text 4 платный — можно ли пользоваться бесплатно?
Редактор распространяется по модели условно-бесплатной: без лицензии он работает без ограничений по функциям, но периодически показывает напоминание о покупке. Лицензия приобретается на официальном сайте разработчика и действует на личное использование.
Чем LSP-pyright лучше плагина Anaconda?
Pyright — это тот же анализатор, что используется в VS Code: он быстрее, точнее работает с аннотациями типов и активнее поддерживается. Anaconda проще в установке (не требует Node.js), но развивается медленнее. Одновременно оба плагина ставить нельзя — они конфликтуют.
Как запустить скрипт с аргументами командной строки?
В файле .sublime-build добавьте аргументы в массив cmd после "$file", например: "cmd": ["python3", "-u", "$file", "--verbose"]. Для разных наборов аргументов создайте отдельные профили сборки и переключайтесь между ними через Tools → Build System.
Можно ли отлаживать Python-код в Sublime Text 4?
Встроенного отладчика в редакторе нет. Практичные варианты: использовать модуль pdb из стандартной библиотеки с запуском в терминале (например, через плагин Terminus) или ставить точки останова через breakpoint() и запускать скрипт во внешнем терминале. Полноценная графическая отладка — территория IDE вроде PyCharm или VS Code.