indent-rainbow插件通过彩色缩进线提升VSCode代码可读性，需安装插件、启用默认配置、自定义颜色与深度、排除特定语言、同步缩进设置以确保正常渲染。
如果您在使用 VSCode 编写代码时希望更直观地区分不同层级的缩进，indent-rainbow 插件可通过色彩化缩进引导线提升代码可读性。以下是启用并优化该插件的具体操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 indent-rainbow 插件
该插件需通过 VSCode 扩展市场获取并安装，确保其处于启用状态后才能渲染彩色缩进线。
1、打开 VSCode，点击左侧活动栏中的扩展图标（或按快捷键 Cmd+Shift+X）。
2、在扩展搜索框中输入 indent-rainbow，找到作者为 oderwat 的官方插件。
3、点击插件右侧的 Install 按钮完成安装。
4、安装完成后，重启 VSCode 或重新加载当前窗口（Cmd+Shift+P → 输入 Developer: Reload Window → 回车）。
二、启用默认颜色配置
插件安装后默认启用基础彩虹配色方案，但需确认设置未被用户自定义覆盖，以确保视觉效果正常生效。
1、按下 Cmd+, 打开设置界面。
2、在搜索框中输入 indentRainbow。
3、确认 Indent Rainbow: Enable 选项已勾选。
4、检查 Indent Rainbow: Colors 值为默认数组，例如 ["rgba(255,255,64,0.2)", "rgba(255,128,64,0.2)", "rgba(128,255,64,0.2)"]。
三、自定义缩进颜色与深度
可通过修改 settings.json 直接调整每级缩进的颜色、透明度及最大高亮层级，满足个性化阅读习惯。
1、按下 Cmd+Shift+P，输入 Preferences: Open Settings (JSON) 并回车。
2、在 JSON 文件的 "settings": { } 对象内添加以下配置项：
3、插入键值对 "indentRainbow.colorOnWhiteSpace": true，使空白区域也响应颜色渲染。
4、插入键值对 "indentRainbow.tabSize": 2，设定以 2 个空格为一级缩进单位（适配 Python/TypeScript 等主流风格）。
5、插入键值对 "indentRainbow.colors": ["#ff000033", "#00ff0033", "#0000ff33", "#ff00ff33"]，定义前四级缩进分别使用红、绿、蓝、紫四色半透效果。
四、禁用特定语言的缩进着色
部分语言（如 Markdown 或纯文本）可能因缩进语义不明确而出现误着色，此时可针对性排除。
1、在 settings.json 中定位到 "indentRainbow.excludeLanguages" 配置项。
2、若该键不存在，则新增一行，格式为："indentRainbow.excludeLanguages": ["markdown", "plaintext"]。
3、保存文件后，重新加载窗口使配置生效。
五、调试缩进渲染异常
当缩进线未显示或颜色错乱时，通常由编辑器缩进设置与插件检测逻辑不一致导致，需同步统一配置。
1、打开任意代码文件，右下角状态栏查看当前缩进模式，确认显示为 Spaces: 2 或 Tabs。
2、点击该区域，选择 Indent Using Spaces 并设定为 2（或匹配项目规范）。
3、按下 Cmd+Shift+P，执行 Indent Rainbow: Show Debug Info 命令。
4、观察输出面板中是否提示 "Active: true" 及当前检测到的缩进宽度数值。
