VSCode默认不识别.blade.php文件类型，需手动设为Blade语言模式并配置shufo.vscode-blade-formatter为默认格式化器，否则高亮、补全、缩进及Tailwind类排序均失效。
VSCode 默认不识别 .blade.php 文件的混合语法，直接打开会丢失 Blade 指令高亮、PHP 补全和 HTML 结构感知——这不是配置错了，是根本没告诉编辑器“这是什么文件类型”。
Blade 文件未被正确识别：先改 language mode
VSCode 不会自动把 index.blade.php 当作 Blade 文件处理，它常 fallback 到 PHP 或 HTML 模式，导致 @if、{{ $user }} 等语法无高亮、无缩进、无补全。
- 打开任意
.blade.php文件，在右下角状态栏点击当前语言标识（如PHP） - 在弹出菜单中搜索
Blade，选择Blade（不是PHP或HTML） - 点击右上角 ✅ “Configure file association for '.blade.php'”，设为默认
这一步必须做，否则后续所有格式化插件都运行在错误的语言上下文中，补全失效、指令被当作文本处理。
vscode-blade-formatter 格式化失效：检查默认 formatter 是否绑定
即使装了 vscode-blade-formatter，如果 VSCode 仍用 PHP 或 Prettier 处理 .blade.php，格式化就会跳过 Blade 特有结构，比如把 @foreach 块缩进错位，或忽略 class 属性重排。
- 确保已安装插件：
shufo.vscode-blade-formatter（作者 shufo，非其他同名但不维护的版本） - 打开设置（
Ctrl+,），搜索default formatter blade - 找到
Editor: Default Formatter下的[blade]条目，设为shufo.vscode-blade-formatter - 验证：打开
.blade.php文件，按Ctrl+Shift+I，观察@section块是否整体缩进、class="p-4 bg-blue-500"是否重排为class="bg-blue-500 p-4"
Tailwind 类不排序：确认配置项已启用且路径正确
vscode-blade-formatter 默认不开启 Tailwind 类排序，且依赖项目根目录存在有效的 tailwind.config.js 才能按配置规则排序（比如 flex 在 bg- 前）。
- 在项目根目录创建或确认已有
tailwind.config.js（哪怕只含module.exports = {}） - 在
.bladeformatterrc中显式启用："sortTailwindcssClasses": true - 若使用
.bladeformatterrc.json，注意 JSON 语法严格，true不能加引号 - 重启 VSCode 或重新加载窗口（
Ctrl+Shift+P→Developer: Reload Window），否则配置不热更新
和 Prettier 冲突：别让两个 formatter 同时抢着格式化
如果你同时装了 Prettier 和 vscode-blade-formatter，又没明确分工，VSCode 可能随机调用其中一个，导致 @php 块被当成 JS 格式化、或 class 排序一半就停。
- 在工作区
.vscode/settings.json中强制指定："[blade]": { "editor.defaultFormatter": "shufo.vscode-blade-formatter" } - 禁用 Prettier 对 Blade 的接管：确保
.prettierrc中没有"parser": "blade"，或删掉prettier-plugin-blade - 若坚持用 Prettier 统一管理，就卸载
vscode-blade-formatter，改用prettier-plugin-blade+prettier，但要注意它对复杂嵌套指令的支持不如原生 Blade formatter 稳定
最易被忽略的是 language mode 设置——90% 的“格式化没反应”“高亮不生效”问题，根源都在右下角那个没点开的语言切换菜单里。一旦设错，插件再强也无从下手。
