VSCode缩进导轨需同时启用"editor.renderIndentGuides"和"editor.guides.indentation"，颜色通过workbench.colorCustomizations配置editorIndentGuide.background等变量实现，不支持像素级粗细调整；其显示依赖语言模式与缩进规则，与固定列的Editor Ruler本质不同。
怎么让 VSCode 显示竖线对齐缩进导轨
VSCode 默认开启缩进导轨（indent guide），但部分主题或设置可能让它不明显甚至完全不可见。关键不是“开不开”，而是它依赖两个独立开关："editor.renderIndentGuides" 和 "editor.guides.indentation" —— 后者是 1.82+ 版本引入的新控制项，旧配置可能已失效。
实操建议：
- 打开设置（
Ctrl+,或Cmd+,），搜索renderIndentGuides，确保勾选； - 再搜
guides.indentation，确认设为true（注意：它默认是true，但某些自定义主题或扩展会覆盖）； - 如果仍不显示，检查当前颜色主题是否禁用了导轨样式（比如某些高对比度主题会隐藏细线）；
- 重启 VSCode 不必要，改完设置实时生效。
如何修改缩进导轨的颜色和粗细
VSCode 不提供 UI 滑块调颜色或像素级调粗细，所有样式必须通过 workbench.colorCustomizations 手动注入 CSS 变量。真正起作用的是 editorIndentGuide.background 和 editorIndentGuide.activeBackground 这两个 token，其它如“粗细”其实是靠 SVG 背景图模拟的 —— 所以你改不了像素值，只能换背景图或用渐变伪造“更粗”感。
实操建议：
- 在
settings.json中添加："workbench.colorCustomizations": { "editorIndentGuide.background": "#b0b0b040", "editorIndentGuide.activeBackground": "#5a5a5a" } -
#b0b0b040是带透明度的灰色，避免干扰代码；纯色如#ccc在浅色主题下容易看不清； - 不要尝试设成
rgb(200,200,200,0.3)—— VSCode 只认十六进制带 alpha 的写法（#rrggbbaa）； - 没有
indentGuide.thickness这类配置项，所谓“加粗”只能靠提高亮度/对比度，或配合插件（如Indenticator）用字符模拟，但那已不是原生导轨。
为什么缩进导轨在某些语言里不显示或错位
导轨是否绘制、对齐到哪一级，取决于语言服务器提供的 indentationRules 和 editor 的 onEnterRules 配置。比如 .vue 文件若没装 Volar，<script></script> 块内缩进导轨可能断在标签闭合处；又或者 Python 中 tab 和空格混用时，导轨会按物理列数画线，而非逻辑缩进层级，造成视觉错位。
实操建议：
- 确认文件绑定了正确语言模式（右下角状态栏检查是否显示
Python、Vue等，而不是Plain Text）； - Python 项目务必统一用空格缩进（
"editor.insertSpaces": true+"editor.detectIndentation": true）； - 对于自定义语法（如 DSL、JSONC 注释），导轨可能完全不触发 —— 因为这些语言没声明
indentationRules，此时只能靠格式化工具（如 Prettier）辅助对齐； - 不用指望导轨解决嵌套 JSX 或模板字符串里的缩进问题，它只响应编辑器层面的行首空白，不解析语法树。
缩进导轨和 Editor Ruler（垂直标尺）有什么区别
这是最常被混淆的一点：缩进导轨（indent guide）是随代码缩进自动出现的虚线，而 Editor Ruler（editor.rulers）是固定列位置的竖直线，比如你在第 80 列画一条红线提醒换行。两者渲染机制、配置路径、用途完全不同，不能互相替代。
实操建议：
- Ruler 用
"editor.rulers": [80, 120]设置，颜色由editorRuler.foreground控制； - 缩进导轨永远贴着实际缩进位置，Ruler 永远固定列数，哪怕那列是空格中间；
- 同时启用时，Ruler 线会压在导轨上（z-index 更高），如果颜色相近，导轨可能被盖住；
- 别用 Ruler 来“假装”导轨 —— 它不会随
Tab缩进动态增减，也不响应折叠区域。
导轨的底层逻辑是“基于空白符的列对齐”，不是“基于 AST 的语义缩进”。这意味着它快、轻量，但也注定无法理解代码含义。真要靠语义对齐，得靠语言服务器 + Outline 视图，而不是盯着这几条线看。
