vscode 中垂直参考线的官方术语是 editor.rulers(复数数组)。通过 settings.json 设置如 "editor.rulers": [80, 120] 启用,设为空数组或删除该字段即可关闭;单位为列数,多值对应多条线,受工作区/语言专属设置及主题渲染影响。

垂直参考线在 VSCode 里叫什么?
它不叫“参考线”或“guides”,官方术语是 editor.rulers —— 注意是复数,而且是个数组。很多人搜“vertical line”“guideline”找不到设置,就是因为没对上这个关键词。
怎么开启/关闭 rulers(垂直参考线)?
直接改用户或工作区设置即可,无需插件。最常用的是在 settings.json 里操作:
- 打开命令面板(
Ctrl+Shift+P/Cmd+Shift+P),输入Preferences: Open Settings (JSON) - 添加或修改
"editor.rulers"字段,例如:"editor.rulers": [80, 120]
- 设为空数组
[]或删掉这一行,就等于关闭
注意:数值单位是列数(character columns),不是像素;多个值会画多条线;只对当前语言或当前工作区生效(取决于你编辑的是用户设置还是工作区设置)
为什么改了没反应?常见踩坑点
最常见的三个原因:
-
editor.rulers被工作区设置覆盖了 —— 检查右下角状态栏的语言模式旁有没有「工作区」字样,再确认你改的是哪个settings.json - 当前文件类型被语言专属设置屏蔽了 —— 比如你在
javascript.json里设了"editor.rulers": [100],但打开的是.py文件,那不会生效 - 用了主题不支持 rulers 的渲染 —— 极少数暗色主题(比如某些自定义主题)会把 ruler 颜色设成透明或和背景同色,可以临时切回
Default Dark+验证
想让某一行单独标出来(比如 TODO 行)怎么办?
editor.rulers 是全局列对齐线,没法按行指定。如果真需要高亮某一行,得换思路:
- 用
TODO Highlight这类插件标记关键词行 - 用
indent-rainbow看缩进层级(间接辅助定位) - VSCode 原生不支持单行垂直线 —— 别在
rulers数组里填负数或字符串,那只会让设置失效
真正灵活的垂直线需求,往往意味着你在处理代码风格约束或审查点,这时候更该检查 linter 配置(比如 ESLint 的 max-len),而不是靠视觉线硬扛











