行号显示需开启line_numbers:true,检查用户设置、语法专属设置、配色方案及UI主题四层配置;宽度由gutter_size等控制,颜色须改color-scheme或theme文件。

行号显示开关必须设对,否则其他样式全白搭
行号不出现,90% 是因为 line_numbers 没开,或被更高优先级配置覆盖。它不是“默认一直开着”的——Sublime Text 4+ 实际上默认是 false。别信菜单里 View → Gutter → Line Numbers 的勾选状态,那只是临时覆盖,不写进配置就无效。
- 打开
Preferences → Settings,只改右侧(User Settings)的 JSON - 确保有且仅有一行:
"line_numbers": true,拼写不能错、不能少引号、不能写成line_number - 如果文件里已有其他设置,记得用英文逗号分隔,JSON 格式必须合法
- Markdown / JSON 等语法专属设置(
Preferences → Settings – Syntax Specific)优先级更高,要单独检查对应文件里有没有"line_numbers": false
行号颜色和背景色只能改配色方案文件,不是改 settings
gutter_background 和 gutterForeground 这类样式字段,根本不在 Preferences.sublime-settings 里生效。它们属于配色逻辑,必须编辑当前启用的配色方案(.sublime-color-scheme 或旧版 .tmTheme)。
- 先确认当前方案名:菜单
Preferences → Color Scheme,比如Monokai.sublime-color-scheme - 进
Preferences → Browse Packages…,找到对应目录(如Color Scheme - Default/),把原文件复制到Packages/User/下并重命名(防升级覆盖) - 在副本中搜索
gutter;没找到就手动加一条规则(.sublime-color-scheme 是 JSON 格式):{ "name": "Gutter", "scope": "gutter", "background": "#2a2e37", "foreground": "#9da5b3" } - 保存后,必须回到
Color Scheme菜单里重新选一次该方案,才会加载新样式
行号区域“宽度”没法直接设,但有三个可控入口
Sublime 没有 gutter_width 这种配置项。所谓“宽”,其实是字体宽度 + 数字位数 + 内边距共同作用的结果。数字超 999 行时被截断,就是典型宽度不足的表现。
-
"gutter_size": 48是唯一能硬控最小宽度的设置,加在用户 settings 里即可(不是 color scheme 文件) -
"gutter_padding": 8是实验性字段,只对部分现代主题(如 Material Theme、Ayu)有效,旧主题会忽略 - 换等宽字体(如 Fira Code)、适当调大
font_size,能让数字渲染更稳定,视觉上“撑开” gutter 区域 -
margin和line_padding_*对 gutter 宽度无影响——前者只动代码区左侧空白,后者只调行高留白
UI 主题也能盖掉行号样式,尤其 gutter_background 容易被忽略
很多人卡在“改了 color scheme 却没变化”,其实是 UI 主题(.sublime-theme)里的 gutter rule 强制覆盖了背景色。配色方案管文字,UI 主题管容器,两者都得查。
- 当前 UI 主题路径通常在
Packages/Theme - Default/Default.sublime-theme或第三方主题目录下 - 打开主题文件,找
"class": "gutter"的 rule 块,确保里面有"gutter_background"字段,值推荐用带 alpha 的十六进制,比如"#282c34cc"(cc ≈ 80% 不透明) - 纯黑
#000000或纯白#FFFFFF容易让断点 ●、Git 标记 ► 发虚或反白;深灰系更安全 - 改完保存,Sublime 一般自动重载 UI;若无反应,可执行
Ctrl+Shift+P → UI: Reload Theme(需插件支持)
真正卡人的从来不是“怎么改”,而是 Sublime 的样式分层:配色方案(color scheme)控制文字色,UI 主题(theme)控制容器背景,用户 settings 控制开关与尺寸,语法专属设置还能临时关掉行号——四层叠在一起,漏查一层,效果就出不来。


















