行号不显示95%是editor.lineNumbers被设为"off"或被高优先级设置覆盖;应按Ctrl+,搜索line numbers,检查并设为"on"或"relative",注意Workspace和语言特定设置可能覆盖用户配置。

行号不显示,95% 是 editor.lineNumbers 被设成了 "off",或者被更高优先级的设置覆盖了——不是 VSCode 坏了,也不是你装错了插件。
怎么立刻确认是不是 editor.lineNumbers 关了
按 Ctrl + ,(Windows/Linux)或 Cmd + ,(macOS)打开设置,直接在搜索框里输入 line numbers。看右侧下拉菜单当前值是不是 "off"。如果是,点开选 "on" 或 "relative",改完立刻生效,不用重启。
注意右下角是否显示 Workspace。如果显示,说明你正处在某个项目里,.vscode/settings.json 可能悄悄把你设回 "off" 了——点进 Workspace 标签页再搜一遍 editor.lineNumbers 就能看见。
editor.lineNumbers 值写错导致静默失效
这个配置只认四个字符串:"on"、"off"、"relative"、"interval"。其他任何写法都会被忽略,且不报错:
- 写成
true、1、"true"、on(没加引号)→ 不生效 - 写成
"ON"或"On"(大小写敏感)→ 不生效 - 写成
"absolute"或"normal"→ 不生效
手动改 settings.json 时,务必用双引号包裹,例如:"editor.lineNumbers": "on"。
为什么改了用户设置还是没行号
VSCode 设置有明确优先级链,高优先级会盖掉低优先级:
- 语言特定设置(如
"[python]": { "editor.lineNumbers": "off" }) - 工作区设置(
.vscode/settings.json,对当前文件夹生效) - 用户设置(全局
settings.json或 GUI 设置) - 默认值(内置为
"on")
最容易被忽略的是语言设置:右下角看当前文件类型(比如显示 Plain Text 或 Markdown Preview),这些模式本就不渲染行号。换一个 .py 或 .ts 文件再试。
相对行号("relative")和主题/折叠的配合问题
"relative" 模式下,光标所在行为 0,上下行是 -1、+1 等。但它有两个真实影响你操作的细节:
- 代码块折叠后,下方所有行的相对数会重算——这不是 bug,但如果你习惯用
Ctrl+G输入+5跳转,得先确保目标区域没被折叠 - 不是所有主题都支持双行号(绝对+相对并存)。想用
"on"+editor.relativeLineNumbers: true的组合,得确认主题兼容(比如默认Dark+可以,GitHub Dark要 v2.0+)
真正难排查的,永远是工作区配置和语言设置这两层——它们藏得深、改得静默、还经常随项目一起提交。每次 clone 新仓库后第一件事,就是看一眼右下角有没有 Workspace,再搜一次 editor.lineNumbers。











