Sublime Text行号不显示的主因是line_numbers设为false、拼写错误、被注释、JSON语法错误或被更高优先级设置/主题/插件覆盖;需检查用户设置、语法专属设置、主题及插件影响。

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 解析失败,整段设置失效
改完保存即生效,无需重启。如果仍不显示,说明问题不在这一层。
新版 Sublime Text 4+ 的菜单路径是 View → Gutter → Line Numbers
v4.5+ 版本已把开关从旧版 View → Line Numbers 移到了子菜单里。很多人卡在这一步,因为一级菜单根本找不到。
操作方式:
- 打开任意文件,点顶部
View - 悬停在
Gutter上,等子菜单弹出 - 检查
Line Numbers前是否有勾;没有就点一下
这个操作是临时切换,不改任何配置文件,适合快速验证是否是设置问题。如果点一下就出来了,说明你本地的 line_numbers 配置可能被覆盖或失效。
排查语法专属设置(如 Markdown.sublime-settings)
你可能在写 Markdown 时关过行号,结果 Sublime 自动创建了 Packages/User/Markdown.sublime-settings,里面写了 "line_numbers": false。这个文件的优先级高于全局设置,一打开 Markdown 文件就“全局失效”。
解决方法:
- 打开一个 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 的插件。
真正麻烦的从来不是“怎么开”,而是“为什么开了还不显示”——优先级、隐藏区域、全屏模式(F11)、Distraction Free Mode 这些干扰项,比配置本身更常被忽略。

















