缩进参考线在 Settings/Preferences → Editor → General → Appearance 中勾选 Show indent guides 开启，它仅提供视觉对齐提示，不控制实际缩进逻辑；颜色需在 Color Scheme → General 中修改 Indent guide 和 Indent guide active 项，并另存为新方案。
缩进参考线在哪开——不是在 Code Style 里
缩进参考线（indent guides）的开关藏在 Settings/Preferences → Editor → General → Appearance，勾选 Show indent guides 即可。很多人翻遍 Editor → Code Style → JavaScript 找不到，是因为它和缩进逻辑完全无关，只负责画竖线。
常见误操作：
- 以为开了这个就能自动修正缩进——其实它纯属视觉提示，不改变任何实际字符
- 调了
Tab size发现参考线没变——参考线间隔由Indent值决定（比如设为 2，线就每 2 字符出现一次），和Tab size无关 - 空行看不到线——默认开启
Hide indentation guides for empty lines，这是正常行为，不是 bug
参考线颜色太淡看不清怎么办
WebStorm 不提供独立的“缩进线颜色”滑块，而是复用配色方案里的 Indent guide 和 Indent guide active 两项。深色主题下容易失效，解决路径是：
- 进入
Settings/Preferences → Editor → Color Scheme → General - 在右侧列表中找到
Indent guide（普通层级线）和Indent guide active（光标所在层级的加粗线） - 双击修改颜色，注意要点击
Save As…另存为新方案，否则会覆盖默认配色 - 如果改完仍不明显，可能是主题限制了透明度，可临时切换到
Default或Dracula方案再调
为什么有些文件不显示缩进线
缩进参考线依赖编辑器对文件结构的基本解析能力，不是所有文件都支持。典型现象包括：.blade.php 里的 PHP 片段、.vue 中的 script 区域、无后缀脚本、或 .env 文件。
排查步骤：
- 看右下角状态栏：确认文件类型显示为
PHP、Vue.js或JavaScript，不是Text；如果不是，点击后手动选择正确类型 -
.blade.php需已安装并启用Laravel Idea或官方Blade Support插件，否则 PHP 区域不参与缩进计算 - 临时禁用所有第三方插件测试——某些老旧插件（如旧版
PHP Annotations）会干扰结构感知
缩进参考线和实际缩进设置的关系
参考线只反映当前文件的**实际缩进字符分布**，它不读取 .editorconfig，也不受 Detect and use existing file indents 是否开启影响——只要某行开头有空格或 Tab，就会画线。
但要注意：
- 参考线间隔始终按当前语言的
Indent值渲染（例如 JavaScript 设置为 2，HTML 设置为 4，那两个文件的线距就不同） - 即使你关掉了
Show indent guides，代码格式化（Ctrl+Alt+L）仍按Code Style设置执行，二者完全解耦 - 如果你同时启用了
Detect and use existing file indents，参考线会动态跟随文件已有缩进风格，但这只是显示效果，不影响你的Code Style配置本身
File → Settings → Editor → Inspections → JavaScript → Mixed spaces and tabs 这类检查项来暴露。 
