PHP文件缩进异常的根源在于语言模式未设为PHP、缺少PHP格式化器或formatOnPaste配置冲突；需先确认右下角语言模式为PHP，再配置tabSize、autoIndent及defaultFormatter，并根据需要关闭formatOnPaste。
PHP 文件默认不按 PHP 规范缩进？先检查语言模式
VS Code 不会自动为 .php 文件启用 PHP 语言功能，如果右下角状态栏显示的是 Plain Text 或 HTML，那所有 PHP 相关的缩进规则都不会生效。必须确保当前文件的语言模式是 PHP —— 点击右下角语言标识，选择 PHP（或按 Ctrl+K M 快速切换）。
修改 workspace 或 user 级别的 PHP 缩进配置
VS Code 的缩进行为由 editor.tabSize、editor.insertSpaces 和语言专属设置共同决定。对 PHP 来说，推荐在工作区（.vscode/settings.json）中显式覆盖，避免受全局设置干扰：
{
"editor.tabSize": 4,
"editor.insertSpaces": true,
"[php]": {
"editor.tabSize": 4,
"editor.insertSpaces": true,
"editor.autoIndent": "full",
"editor.formatOnSave": true
}
}
注意："[php]" 是语言专属配置块，比通用设置优先级更高；"autoIndent": "full" 能让回车/粘贴/括号匹配时保持正确层级；若用的是 PHP Intelephense 或 PHP Tools 插件，它们可能额外提供 php.suggest.basic 等控制项，但缩进本身不依赖这些插件。
格式化触发后缩进仍错乱？检查是否启用了 PHP 格式化器
editor.formatOnSave 生效的前提是 VS Code 找得到可用的 PHP 格式化器。默认不带 PHP 格式化能力，必须安装扩展并指定：
立即学习“PHP免费学习笔记（深入）”；
- 装好
PHP Intelephense或PHP CS Fixer（后者需本地安装php-cs-fixerCLI） - 在
settings.json中设"php.suggest.basic": false（Intelephense 下建议关闭内置建议） - 明确指定格式化工具：
"editor.defaultFormatter": "bmewburn.vscode-intelephense-client"或"editor.defaultFormatter": "junstyle.php-cs-fixer" - 若用
php-cs-fixer，还需配"php-cs-fixer.executablePath"指向可执行文件路径
没有格式化器时，formatOnSave 实际不做事，缩进仅靠编辑器自动换行逻辑，容易在 if/foreach 块内失准。
粘贴代码后缩进爆炸？关掉“粘贴时自动调整缩进”陷阱
VS Code 有个隐藏行为：当 editor.formatOnPaste 为 true，且当前有 PHP 格式化器时，粘贴会强制重排——但若剪贴板里混着 Tab 和空格、或缩进层级与当前文件不一致，结果常是整段偏移。临时解决办法：
- 把
"editor.formatOnPaste"设为false（尤其在协作项目中） - 粘贴前先按
Shift+Alt+F手动格式化当前文件，再粘贴 - 用
Ctrl+Shift+P→Developer: Toggle Developer Tools查看 Console 是否报Failed to format document，这说明格式化器挂了或配置路径错误
PHP 缩进问题表面是空格数不对，根子常在语言模式识别失败、格式化器缺失或 formatOnPaste 和协作代码风格冲突——调的时候别只盯着 tabSize 改。
