editor.linenumbers 的合法值仅为 "on"、"off"、"relative"、"interval" 四个字符串；不支持布尔值、数字或无引号写法，错误配置将被静默忽略。
editor.lineNumbers 的合法取值只有四个字符串
VSCode 不接受布尔值或数字，editor.lineNumbers 的配置值必须是 "on"、"off"、"relative" 或 "interval" 中的一个。写成 true、"true"、1 或漏掉引号都会导致设置无效——行号不会显示，且 VSCode 不报错，只会静默忽略。
常见错误现象：
- 改完
settings.json后行号没变化 → 检查引号和拼写 - 用快捷键 Ctrl+, 搜索 “line numbers” 却找不到选项 → 可能被工作区设置覆盖，切到“用户”标签页再找
相对行号在 Vim 模式下跳转更高效，但折叠后数字会重算
"relative" 模式让当前光标所在行为 0，上一行是 -1，下一行是 1，以此类推。这对 5j、12k 这类移动命令特别直观——你一眼就能看出要往下跳几行。
但要注意：
VSCode 1.118
下载
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 代码块折叠时，下方所有行的相对值会立刻重算，不是 bug，是设计如此
- 函数内嵌套折叠多层后，
10j可能落到意料之外的位置，建议配合za（切换折叠）使用 - 不支持“插入模式切回绝对行号”的原生功能；所谓“智能相对行号”需依赖 Vim 插件扩展（如
vim.vimrc.enable+ 外部.vimrc配置），VSCode 本身无此能力
修改后无需重启，但工作区设置优先级高于用户设置
改完 editor.lineNumbers 立即生效，不用关文件、不用重载窗口。但如果你在当前项目根目录有 .vscode/settings.json，它的配置会覆盖你全局用户设置里的 editor.lineNumbers。
排查步骤：
- 按 Ctrl+, 打开设置，右上角确认当前是“用户”还是“工作区”标签页
- 搜索
editor.lineNumbers，看右侧是否显示“已由工作区设置覆盖” - 若想统一管理，可删掉工作区中的该配置项，或明确设为相同值
interval 模式只在部分主题下可见，实际用途有限
"interval" 表示“每隔若干行显示一个绝对行号”，但 VSCode 官方未定义间隔数值，不同主题渲染效果不一致：有些每 10 行标一次，有些只在第 1、50、100 行显示，甚至完全不显示数字只留空格。
它不适合调试或跳转，唯一适用场景是：大段纯文本日志查看时减少视觉干扰。日常开发中，"on" 或 "relative" 足够覆盖全部需求。
