缩进参考线在VSCode 1.85+中需设"editor.guides.indentation":true并配合workbench.colorCustomizations配置十六进制颜色值（如#404040）才可见，旧配置editor.renderIndentGuides已弃用，主题未定义color token或语法错误会导致线不可见。
缩进参考线在 VSCode 里不是“开了就一定看得见”的功能——它默认可能已启用，但你大概率根本看不到，原因几乎全是配置项过时 + 主题吃掉了颜色。
editor.guides.indentation 是唯一有效的开关
VSCode 1.85+ 已彻底弃用 editor.renderIndentGuides，哪怕你在 settings.json 里写了 "editor.renderIndentGuides": true，它也完全不生效。别查日志、别重启，删掉这行才是第一步。
-
"editor.guides.indentation": true是当前唯一起作用的配置，值也可以是"active"（只在光标所在缩进层显示） - 如果用了工作区设置（
.vscode/settings.json），它会覆盖全局配置，优先检查那里有没有残留的旧配置 - 运行命令
Developer: Inspect Editor Tokens and Scopes，把光标停在缩进行，右下角能直接看到实际生效的editor.guides.indentation值
workbench.colorCustomizations 是让线“露出来”的唯一方式
开了开关却没线？90% 是主题把 editorIndentGuide.background 设成了透明或与背景同色。这不是 bug，是主题作者没定义这个 color token。
- 必须在
settings.json顶层对象里加workbench.colorCustomizations块，不能嵌套在别的字段里 - 最小可用配置是：
"workbench.colorCustomizations": { "editorIndentGuide.background": "#404040", "editorIndentGuide.activeBackground": "#606060" } - 值必须是十六进制（如
#333或带 alpha 的#40404040），rgb()、gray、英文名全都不认，静默失败 - 改完保存即生效；若仍不显，先切到
Default Dark+主题验证是不是主题问题
缩进线错位？根源不在设置，在缩进本身
缩进参考线不解析空格或 Tab 字符，它只按编辑器当前识别出的“逻辑缩进层级”画线。错位基本等于缩进不一致。
- 看右下角状态栏：确认显示的是
Spaces: 2这类明确值，而不是Auto或空白 - 设
"editor.detectIndentation": true，让 VSCode 打开文件时自动识别已有缩进习惯 - 避免手动混用：比如一行用 2 空格，下一行插了个 Tab——VSCode 可能误判为多一级，线就偏了
- 某些语言模式（如 Markdown 预览、Jupyter Notebook 编辑器）压根不渲染缩进线，换到
plaintext或对应语言模式测试
最常被忽略的点：整个 workbench.colorCustomizations 块只要有一个语法错误（比如多逗号、单引号、括号不闭合），所有自定义颜色都会静默失效——线不是变淡，是彻底消失，且没有任何提示。
