Как включить relative line numbers в VS Code

Как переключить lineNumbers

1. Откройте Settings и найдите Editor: Line Numbers.
2. Выберите Relative в выпадающем списке.
3. Либо добавьте в settings.json `"editor.lineNumbers": "relative"`.
4. Переместите курсор на несколько строк вниз и убедитесь, что числа вокруг пересчитались.
5. Если режим нужен только в одном профиле или проекте, сохраните настройку в соответствующем scope.

Совет: Не путайте relative line numbers с номером строки в Status Bar: там по-прежнему отображается абсолютная позиция курсора.

Как читать относительные номера

Число рядом со строкой означает, сколько строк отделяет её от текущей позиции. Например, значение 5 сверху означает, что до этой строки пять перемещений по строкам. Сам код не меняется: это только элемент интерфейса редактора. Поэтому переключение безопасно для репозитория и не создаёт diff. Если абсолютный номер нужен для сообщения об ошибке, его можно увидеть в строке состояния или временно вернуть обычный режим.

Значения editor.lineNumbers

• on. обычные абсолютные номера
• relative. расстояние от строки курсора
• off. номера строк скрыты

Когда лучше User setting, а не Workspace

Нумерация строк — личное представление интерфейса и обычно не влияет на код. Поэтому её чаще оставляют в User settings или профиле VS Code. Записывать relative mode в `.vscode/settings.json` имеет смысл только если команда действительно договорилась о таком интерфейсе; иначе проект будет неожиданно менять привычное отображение у коллег.

Важно: Для чистоты репозитория не добавляйте личные UI-предпочтения в Workspace без общей причины.

Если режим не включился

• проверьте, не переопределён ли lineNumbers в Workspace;
• посмотрите language-specific settings;
• убедитесь, что редактируете именно Editor: Line Numbers, а не terminal settings;
• перезагрузите окно только после проверки effective value.

Предупреждение: Расширения Vim могут менять навигацию, но сами относительные номера задаются штатной настройкой редактора.

Когда относительные номера помогают, а когда мешают

Относительная нумерация полезна при навигации командами, потому что сразу показывает расстояние до соседней строки, но сообщения компилятора и ссылки из логов всё равно обычно используют абсолютный номер. Поэтому при отладке держите в уме, что число слева — расстояние, а не адрес строки; для точного перехода используйте переход к строке или временно верните обычную нумерацию. В текущей строке редактор может показывать абсолютное значение, что помогает не терять ориентир. Если режим мешает на демонстрации экрана или при совместном разборе кода, переключение занимает секунды и не меняет сам файл.

Что учитывать

Условия меняются. Страница отражает состояние на 2026-09-23; при расхождении с официальной документацией приоритет у первоисточника.

Источники и проверка

Фактическая часть сверена по первичным источникам (в т.ч. September 2016 (version 1.6) — relative line numbers). Пример и формулировки — редакция N1RO на 2026-09-23.

• September 2016 (version 1.6) — relative line numbers
• User and workspace settings