sublime text行号不显示的主因是设置被覆盖或失效,需按顺序排查:菜单临时开关→用户设置line_numbers:true→语法专属设置→主题/插件隐藏gutter。

Sublime Text 默认开启行号,但多数“没看到”的情况,不是没开,而是 line_numbers 被设为 false、拼错、注释掉,或被更高优先级的设置/主题/插件覆盖了。
检查用户设置中 line_numbers 是否为 true
打开 Preferences → Settings,只看右侧「User Settings」面板。确认存在且仅有一行:
"line_numbers": true
常见错误包括:
-
"line_number": true(少个s,JSON 键名不匹配) -
// "line_numbers": false(整行被注释,Sublime 不解析注释) - 已有其他配置但末尾漏逗号,导致 JSON 解析失败,整段设置失效
改完保存即可生效,无需重启。如果仍不显示,说明问题不在这一层。
确认菜单路径是 View → Gutter → Line Numbers
Sublime Text 4+ 版本已将开关移出一级菜单,View → Line Numbers 不存在。必须:
- 打开任意文件,点顶部
View - 悬停在
Gutter上,等子菜单弹出 - 检查
Line Numbers前是否有勾;没有就点一下
这个操作是临时切换,不改任何配置文件,适合快速验证是否是设置问题。如果点一下就出来了,说明你本地的 line_numbers 配置可能被覆盖或失效。
排查语法专属设置覆盖全局行为
右键当前文件标签 → Settings – Syntax Specific,打开的文件里如果存在:
"line_numbers": false
那它会直接屏蔽全局设置,哪怕 Preferences → Settings 里写的是 true 也无效。这类设置自动存为:
Packages/User/Markdown.sublime-settings
或 JSON.sublime-settings 等,容易被遗忘。尤其当你写文档时关过一次 Markdown 行号,之后所有 Markdown 文件就再也不会显示——这不是 Bug,是设计如此。
主题或插件隐藏了 gutter 区域
某些 UI 主题(如 ayu、Material Theme)或插件(如 Origami、旧版 SideBarEnhancements)会通过 CSS 直接隐藏 gutter,导致 line_numbers: true 完全无效。
快速验证方法:
-
Preferences → Theme → Adaptive.sublime-theme(切回默认主题) - 如果行号立刻出现,就是主题问题
- 再逐个禁用插件,重点关掉动过 sidebar/gutter 的插件
别去手动改主题的 .sublime-theme 文件——gutter 渲染逻辑复杂,修错一行可能导致整个边栏消失。
真正麻烦的从来不是“怎么开”,而是 Sublime 的设置分层:全局设置、语法专属设置、主题渲染、插件注入,四层都可能挡住行号。查的时候得一层层剥,从菜单临时开关开始,再到用户配置、语法配置、最后换主题验证——跳过任何一层,都可能卡住半天。











