必须在workbench.colorcustomizations中用十六进制带alpha值（如#40404022）配置editorindentguide.background和activebackground，否则线因主题设为透明而不可见；1.85+版本已弃用editor.renderindentguides，仅editor.guides.indentation生效。
缩进参考线颜色不能通过主题切换或简单开关控制，必须手动在 workbench.colorCustomizations 中用十六进制带 alpha 值（#rrggbbaa）精确配置两个 token：否则线会“开了但看不见”——不是功能失效，是颜色被主题设为透明或与背景同色。
为什么改了 settings.json 还没线？
常见错误现象是：明明写了 "editor.guides.indentation": true，缩进线依然不可见。这不是配置没生效，而是 VSCode 1.85+ 版本起，缩进线渲染完全依赖 workbench.colorCustomizations 中的两个颜色字段，其它任何写法都会静默失败。
- 删掉已废弃的
"editor.renderIndentGuides": true—— 它在新版中仅作兼容，设为true不保证开启，设为false才会强制关闭 - 确认没误用工作区设置（
.vscode/settings.json），它会覆盖全局配置；优先检查右下角状态栏语言模式是否识别正确（如显示JavaScript而非Plain Text） - 运行命令
Developer: Inspect Editor Tokens and Scopes，把光标停在缩进行，右下角会直接显示当前生效的editor.guides.indentation值和实际应用的 color token - 某些主题（如 One Dark Pro、Nord）压根没定义
editorIndentGuide.background，导致该 token 默认为透明；临时切回Default Dark+主题可快速验证
怎么配才真正生效？
workbench.colorCustomizations 是唯一有效路径，且只认严格格式：双引号包裹、合法 JSON、十六进制带 alpha（#rrggbbaa），不支持 rgb()、rgba() 或英文名（如 gray）。
-
"editorIndentGuide.background"控制所有非光标所在层级的线，建议用半透灰（如#40404022），避免干扰代码阅读 -
"editorIndentGuide.activeBackground"控制光标所在行对应那条线，可用更实的颜色（如#606060）模拟“加粗”效果 - 整个
workbench.colorCustomizations区块一旦语法出错（比如多逗号、单引号、尾随逗号），会静默失效——务必用双引号、校验 JSON 格式 - 改完保存即生效，无需重启；若仍不明显，先关掉所有插件（尤其是接管缩进渲染的
indent-rainbow或Indenticator）单独测试原生行为
想实现彩虹色或多级样式怎么办？
原生机制只支持两档颜色（普通 / 活动），不提供虚线、点线、不同层级独立配色等能力。要突破限制，只能靠插件接管，且必须关闭原生线避免重叠干扰。
- 装
indent-rainbow-legacy（v9.0.0+），修复了 VSCode 1.89+ 的 API 兼容问题；启用后配"indentRainbow.colors": ["#A6E22E", "#F92672", "#66D9EF"]即可按层级循环上色 - 或启用
Bracket Pair Colorizer 2的"bracketPairColorizer2.showVerticalScopeLine": true，它会沿括号嵌套自动画垂直作用域线，视觉接近彩虹缩进，且无兼容风险 - 启用插件后，务必删掉或设
"editor.guides.indentation": false，否则原生线与插件线叠加，可能造成错位或颜色混杂
最容易被忽略的是：颜色值后两位 alpha 必须显式指定（如 22 表示约 13% 不透明度），缺了就默认为 ff（完全不透明），在深色主题下容易刺眼；而填 00 就彻底隐形——这正是很多人反复调试却“看不见线”的根源。
