VS Code 中 PHP 文件自动保存不生效，主因是 files.autoSave 未启用或被 .vscode/settings.json 覆盖为 "off"，或语言模式误设为 HTML/Plain Text；需检查全局及工作区设置、显式配置 files.autoSave 为 afterDelay、确认语言模式为 PHP、排查格式化插件干扰。
VS Code 中 PHP 文件自动保存不生效，大概率不是 PHP 插件问题，而是 files.autoSave 设置未启用或触发条件不匹配。
确认 files.autoSave 是否已开启
VS Code 的自动保存是全局设置，和语言无关。即使装了 PHP 插件，若该配置为 "off"，任何文件都不会自动保存。
- 按
Ctrl+,（Windows/Linux）或Cmd+,（macOS）打开设置 - 搜索
files.autoSave - 确保下拉值不是
off；推荐选afterDelay（默认延迟 1 秒）或onFocusChange（切出编辑器时保存） - 检查设置左侧图标：蓝色 ✔ 表示工作区生效，灰色圆点表示仅用户级设置——若在项目根目录有
.vscode/settings.json，它可能覆盖全局设置
检查 .vscode/settings.json 是否禁用了自动保存
很多 PHP 项目（尤其 Laravel、WordPress 模板）自带 .vscode/settings.json，里面常含 "files.autoSave": "off" 或遗漏该字段导致继承默认 off。
- 打开项目根目录的
.vscode/settings.json - 查找
files.autoSave字段：若值为"off"，直接删掉这行或改为"afterDelay" - 若整个文件里没有这个字段，不代表“没设置”——它会继承上层设置；但 VS Code 有时会因配置加载顺序误判，建议显式写入：
{
"files.autoSave": "afterDelay",
"files.autoSaveDelay": 500
}
"files.autoSaveDelay": 500 表示 500ms 后保存，比默认 1000ms 更灵敏，适合 PHP 模板频繁修改场景。
PHP 文件被识别为其他语言模式？
如果当前编辑器右下角显示的是 Plain Text、HTML 或 Twig 而非 PHP，VS Code 可能未加载 PHP 相关保存钩子（尽管不影响 files.autoSave 本身，但部分格式化插件如 php-cs-fixer 依赖语言模式触发保存后操作）。
- 点击右下角语言标识（如
PHP），选择Configure Language Specific Settings... - 在弹出的 JSON 中确认是否意外加了
"files.autoSave": "off" - 手动切换语言模式：按
Ctrl+K M→ 输入php→ 回车，确保状态栏显示PHP - 检查文件后缀是否被映射错：比如
.phtml默认不关联 PHP，需在设置中搜files.associations，添加"*.phtml": "php"
保存时卡住或报错导致“看似没保存”
自动保存流程是：修改 → 触发保存 → 执行保存前钩子（如格式化、ESLint）→ 写入磁盘。任一环节失败都会让文件停留在“已修改”状态，看起来像没保存。
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，看 Console 是否报错，例如Failed to run 'php-cs-fixer' on save - 临时禁用 PHP 格式化插件（如
Felix Becker PHP Extension、PHP Intelephense），再测试自动保存是否恢复 - 检查
editor.formatOnSave是否开启且对应格式化工具可用；若不可用，VS Code 可能静默跳过保存步骤
真正卡点往往藏在项目级 .vscode/settings.json 里那行不起眼的 "files.autoSave": "off"，或者语言模式被意外切换成 HTML —— 这两种情况不会报错，但自动保存彻底静音。动手前先看右下角语言标识和设置搜索框里的真实值，比重装插件快得多。
