行号不显示的首要原因是line_numbers被设为false、拼写错误或被注释;其次需检查view→gutter→line numbers菜单项;再排查全屏模式、主题或插件干扰;最后可按语法类型设置line_numbers:false。

行号不显示?先查 line_numbers 是否为 true
Sublime 默认开启行号,但多数“没看到行号”的情况,其实是配置被悄悄改掉了。不是 Bug,是设置项失效了。
-
line_numbers被设成false、拼错成line_number(少个 s),或整行被//注释掉,都会导致 gutter 左侧空荡荡 - 务必只改 Preferences → Settings 右侧的 User Settings,左侧 Default 是只读的,升级后会被覆盖
- 改完保存即可生效,不用重启;如果仍不显示,说明有更高优先级的干扰源(见下一条)
菜单里找不到 Line Numbers?它藏在 Gutter 子菜单里
Sublime Text 4+ 把开关挪到了 View → Gutter → Line Numbers,很多人卡在这步——因为一级菜单 View 下根本没 “Line Numbers” 这个选项。
- 打开任意文件,点 View → 悬停 Gutter → 看子菜单里是否有带勾的 Line Numbers
- 点一下就能即时切换,这是临时开关,不影响配置文件
- 注意:全屏模式、Distraction Free Mode 或侧边栏折叠时,gutter 本身被隐藏,行号自然不可见,不是设置问题
只对 Markdown/JSON 关闭行号?用 Settings – Syntax Specific
全局开行号但写文档时觉得碍眼?别关全局,按语法类型单独控制更合理。
- 打开一个
.md文件 → Preferences → Settings – Syntax Specific - 右侧添加:
"line_numbers": false,保存后仅 Markdown 文件不显示行号 - 这个设置会自动存到
Packages/User/Markdown.sublime-settings,优先级高于全局设置 - 同理可对
.json、.yml等配置文件类型单独关闭
装了主题或插件后行号消失?先切回 Adaptive.sublime-theme
某些 UI 主题(如 ayu、Material Theme)或插件(如 Origami)会直接隐藏 gutter 区域,或者用 CSS 覆盖行号渲染逻辑,导致 line_numbers: true 也无效。
- Preferences → Theme → 选
Adaptive.sublime-theme,看行号是否立刻出现 - 如果恢复了,说明是主题问题;再逐个禁用插件排查,重点关掉 SideBarEnhancements、Origami 这类动过 sidebar/gutter 的插件
- 别试图手动修主题的 .sublime-theme 文件——容易越改越乱,换主题或找兼容版本更稳妥
真正麻烦的从来不是“怎么开”,而是“为什么开了还不显示”。gutter 是个脆弱区域,主题、插件、语法专属设置、全屏模式……任何一层遮住它,行号就没了。查的时候得一层层剥,别一上来就重装。










