行号不显示是配置优先级问题,需依次检查全局设置、语法专属设置、主题插件及全屏模式影响。

行号不显示,90% 是 line_numbers 被设成 false、拼错、注释掉,或被语法专属设置覆盖了——不是 Bug,是配置优先级打架。
检查 line_numbers 是否为 true
Sublime 默认开启行号,但用户设置里只要有一行 "line_numbers": false、"line_number": true(少个 s)、或整行被 // 注释,gutter 就会空着。打开 Preferences → Settings,只看右侧 User Settings 区域,确认有且仅有:
"line_numbers": true
注意逗号分隔和 JSON 合法性;改完保存即生效,不用重启。如果仍不显示,说明更高优先级的设置在起作用。
新版菜单里 Line Numbers 藏在 Gutter 子菜单下
v4+ 版本把开关从旧版 View → Line Numbers 移到了 View → Gutter → Line Numbers。很多人卡在这一步,因为一级菜单里根本找不到。
- 打开任意文件,点顶部
View→ 悬停Gutter→ 看子菜单中Line Numbers前是否有勾 - 没勾就点一下,立刻切换,这是临时操作,不改任何配置文件
- 全屏模式(
F11)或 Distraction Free Mode 下,gutter 本身被隐藏,行号自然不可见——这不是设置问题
语法专属设置(如 Markdown.sublime-settings)优先级更高
你可能在写 Markdown 时关过行号,结果它悄悄生成了 Packages/User/Markdown.sublime-settings,里面写了 "line_numbers": false。这个文件的优先级高于全局 Preferences → Settings,一开就“全局失效”。
- 打开一个 Markdown 文件,执行
Preferences → Settings – Syntax Specific - 删掉里面的
"line_numbers": false,或直接清空该文件 - 同理可查
.json、.yml等类型对应的语法专属设置
主题或插件可能直接隐藏 gutter 区域
像 ayu、Material Theme 或插件 Origami、旧版 SideBarEnhancements,会通过 CSS 把 gutter 区域压窄、透明化,甚至完全移除——此时 line_numbers: true 也白搭。
- 临时切回默认主题:
Preferences → Theme → Adaptive.sublime-theme,看行号是否立刻出现 - 若恢复,说明是主题问题;别手动改
.sublime-theme文件,换兼容版本更稳妥 - 逐个禁用插件验证,重点关掉动过 sidebar/gutter 的插件
真正麻烦的从来不是“怎么开”,而是 gutter 这个区域太脆弱:主题压它、插件藏它、语法设置绕过它、全屏模式直接抹掉它——查的时候得一层层剥,别一上来就重装。











