vscode行号不显示或错位主因是editor.linenumbers值非法、被工作区/语言设置覆盖，或混用弃用字段；应设为"on"/"relative"/"interval"/"off"四字符串之一，修改后立即生效。
VSCode 行号“显示乱”基本不是渲染 bug，而是 editor.lineNumbers 配置值非法、被覆盖，或你误用了已弃用的相对行号逻辑。
为什么改了 settings.json 行号还是不显示或错位
最常见原因有三个：
-
editor.lineNumbers值写成了true、"true"、1或漏引号——VSCode 只认"on"、"off"、"relative"、"interval"这四个字符串，其他一律静默忽略 - 工作区配置（
.vscode/settings.json）优先级高于用户设置，它可能显式写了"editor.lineNumbers": "off"，直接盖掉你全局设的"on" - 语言专属设置干扰，比如
"[typescript]": { "editor.lineNumbers": "off" }会让 .ts 文件永远没行号，而其他文件正常
relative 模式下数字“跳变”是不是配置错了
不是。这是设计行为，不是 bug。
- 相对行号基于光标实时计算：光标在第 42 行，下方第 45 行显示为
3；一旦你折叠一个 8 行函数，原第 45 行变成第 43 行，左边就立刻变成1 - Vim 用户依赖这个特性做
5j、3k跳转，但如果你用正则替换固定行范围（如:42,47s/.../.../），就得切回"on"模式 - 别混用
"editor.lineNumbers": "relative"和editor.relativeLineNumbers: true——后者是旧版 Vim 插件遗留字段，纯 VSCode 环境下已废弃
怎么安全切换绝对/相对/间隔行号
最稳的操作路径是统一走设置界面，避免手误：
- 按
Ctrl + ,（Windows/Linux）或Cmd + ,（macOS）打开设置 - 搜索
line numbers，确保右上角标签页是「User」或「Workspace」，看清当前生效层级 - 从下拉菜单选：
on（绝对）、relative（相对）、interval（隔行）、off（关闭） - 改完立即生效，不用重启、不用重载窗口
如果必须手动改 JSON，请只保留一个 editor.lineNumbers 字段，删掉所有重复项和拼写错误（比如 editor.lineNumber 少个 s）。
interval 模式为什么有时只显示几个数字甚至全空
因为 "interval" 不定义具体间隔值，渲染完全依赖主题实现：
- 默认 Dark+ 主题会每 10 行标一次（第 10、20、30…）
- GitHub Dark v1.x 完全不渲染间隔数字，只留空白
- 某些高对比度主题甚至把间隔行号颜色压成不可见灰
- 它不适合调试或跳转，唯一合理场景是查看超长日志时降低视觉噪音
真正需要快速定位段落，不如用 Ctrl + G 输入行号，或配合大纲视图（Outline）看函数结构——行号本身不是导航工具，只是坐标参考。相对行号的“跳变”和 interval 的“不可靠”，恰恰说明：别指望行号承担它不该干的活。
