VSCode怎么设置代码行号显示_VSCode行号和标尺配置方法【简单】

VSCode行号默认开启但常被配置覆盖；最快开关方式是Ctrl+,搜索“line numbers”修改，或右键编辑器侧边栏切换；值必须为"on"/"off"/"relative"/"interval"字符串，且工作区配置优先级高于用户设置。

很多开发者都遇到过这个情况：打开VSCode，发现代码左侧光秃秃的，行号不见了。其实，VSCode默认是显示行号的，之所以“消失”，十有八九是用户自己的设置或者工作区配置把它给覆盖了。简单来说，问题通常出在 editor.lineNumbers 这个配置项被设成了 "off"，或者工作区的设置优先级更高，把用户设置给“顶”掉了。

怎么快速打开或关闭行号显示

想快速搞定行号显示？最稳妥的方法是通过设置面板。按下 Ctrl + ,（Windows/Linux）或者 Cmd + ,（macOS），在顶部的搜索框里直接输入 line numbers。找到 Editor: Line Numbers 这一项，点开下拉菜单，你会看到四个选项：on、off、relative 和 interval。选一个，立刻生效，完全不需要重启编辑器。

如果只是想临时切换一下当前窗口的行号显示（比如调试完就关掉），有个更快捷的操作：直接在编辑器左侧的空白区域（也就是行号通常出现的位置）点击右键，选择 Toggle Line Numbers。这个操作只对当前打开的文件有效，关闭窗口后设置不会保留。

• "on"：显示绝对行号（1, 2, 3…）。这是最常用的模式，无论是日常阅读代码，还是配合Git查看提交历史（git blame），都非常方便。
• "off"：彻底隐藏行号。能节省一点横向空间，让代码区域看起来更“干净”，但调试和定位代码时会相当不便。
• "relative"：显示相对行号。光标所在行显示为0，上下行则依次显示为±1、±2…。这个模式对使用Vim键绑定的用户来说简直是神器，执行诸如 5j（向下跳5行）、12k（向上跳12行）这类操作时，一眼就能看清距离。
• "interval"：间隔显示行号，比如每10行显示一个数字（10, 20, 30…）。这个模式比较小众，部分编辑器主题可能支持不全，实际使用场景不多。

为什么改了 settings.json 没反应

明明在settings.json里改了配置，行号却纹丝不动？这通常是配置优先级在“作祟”。VSCode的配置加载遵循一个明确的优先级顺序：工作区设置 > 用户设置 > 默认设置。也就是说，如果你在当前项目文件夹下的 .vscode/settings.json 里定义了行号规则，它会优先于你个人用户目录下的全局设置。

排查方法很简单：打开命令面板（Ctrl + Shift + P），输入并执行 Preferences: Open Workspace Settings (JSON)，检查这个文件里是否也包含了 editor.lineNumbers 字段。如果有，修改它才能生效。

另一个高频“坑点”是：editor.lineNumbers 的值必须是一个字符串，而不是布尔值。写成 true、false 甚至 "true" 都是无效的。它只认准这四个字符串字面量："on"、"off"、"relative"、"interval"。

• 错误示例："editor.lineNumbers": true —— VSCode会直接忽略这个配置。
• 注意兼容性：如果你写的是 "editor.lineNumbers": "relative"，但同时安装了某些旧版本的Vim插件，这些插件可能会强制使用已弃用的 editor.relativeLineNumbers: true 来覆盖你的设置。
• 远程开发场景：使用Remote-SSH连接服务器进行开发时，务必记住，需要在远程环境里单独配置一次。本地的用户设置是不会自动同步到服务器端的。

relative 模式下数字“跳变”是不是 bug

在相对行号（relative）模式下，你会发现左侧的数字会随着光标移动、代码折叠而频繁变化。这可不是什么bug，而是精心设计的行为。相对行号的核心就是基于当前光标位置进行实时计算。当你折叠了一段代码，或者插入、删除了几行，光标下方所有行相对于光标的位置都变了，数字自然要重新计算。

举个例子：光标在第50行，你折叠了一个10行的函数块，那么原本的第60行就会变成第51行。在相对行号视图下，它相对于光标的位置就从 10 一下子变成了 1。这种动态特性对于Vim模式下的导航反而是巨大的优势——你想向下移动8行，瞥一眼左边显示的数字 8，直接按 8j 就行，根本不用去数。当然，如果你需要基于固定的行号进行某些操作（比如用正则表达式精确替换某几行），最好还是切回绝对的 "on" 模式。

• 代码折叠不影响绝对行号的显示，但会直接影响相对行号的计算逻辑。
• 当你使用多光标编辑时，相对行号只会根据主光标的位置来计算，其他辅助光标的位置不会参与计算。
• 需要留意的是，相对行号功能通常只在主编辑器区域生效。像集成终端、输出面板、调试控制台这些非核心编辑界面，是不支持相对行号显示的。

话说回来，真正容易让人困惑的，往往是工作区配置和Remote-SSH远程开发场景叠加产生的“双重配置”问题。很多人明明在家里的电脑上把行号调得好好的，一连上公司的开发服务器，发现行号又不见了。这时候，别急着怀疑人生，先去检查一下远程服务器上那个项目的 .vscode/settings.json 文件，很可能答案就在里面。