VSCode需借助外部工具实现PHP代码格式化，推荐PHP CS Fixer；PHP Intelephense仅提供提示与诊断，不支持格式化；须手动配置php-cs-fixer路径及规则文件。
VSCode 本身不内置 PHP 代码格式化能力，必须依赖外部工具（如 php-cs-fixer 或 phpcbf）+ 插件配合才能真正实现可靠、可配置的 PHP 代码美化。
装对插件：PHP Intelephense 不负责格式化
很多人误以为装了 PHP Intelephense 就能自动格式化，其实它只提供智能提示和诊断，不包含格式化逻辑。真正起作用的是：
-
PHP CS Fixer（推荐）：社区最活跃，规则丰富，支持自定义.php-cs-fixer.php -
PHP_CodeSniffer+phpcbf：老牌组合，适合 PSR-12 等标准强约束场景 - 避免使用已停止维护的
PHP Formatter（旧版，不兼容 PHP 8+）
配置 php-cs-fixer 路径和规则文件
插件不会自动找到 php-cs-fixer，必须手动指定可执行路径，并确保规则文件生效：
- 全局安装后，在终端运行
which php-cs-fixer（macOS/Linux）或where php-cs-fixer（Windows），把输出路径填入 VSCode 设置：php-cs-fixer.executablePath - 项目根目录放
.php-cs-fixer.php，内容示例：
<?php
return (new PhpCsFixer\Config())
->setRules([
'@PSR12' => true,
'array_syntax' => ['syntax' => 'short'],
'no_unused_imports' => true,
])
->setFinder(
PhpCsFixer\Finder::create()
->in(__DIR__.'/src')
->in(__DIR__.'/tests')
->name('*.php')
->notName('*.blade.php')
);
注意：setFinder 控制哪些文件参与格式化，漏配会导致 ctrl+shift+i 对某些文件无反应。
立即学习“PHP免费学习笔记（深入）”；
触发格式化的 3 种方式及常见失效原因
不是所有“保存即格式化”都可靠，需检查以下关键点：
- 确保
editor.formatOnSave开启，且[php].editor.formatOnSave显式设为true（优先级更高） - 右键菜单 → “Format Document With...” → 选中
PHP CS Fixer，首次使用会提示是否设为默认；若没出现该选项，说明插件未识别到有效配置 - 命令面板（
ctrl+shift+p）搜PHP CS Fixer: Fix this file可手动触发 —— 这是排查问题最直接的方式 - 常见失效原因：
php-cs-fixer版本太低（.php-cs-fixer.php 有语法错误、VSCode 工作区用了多根文件夹但规则文件不在主文件夹下
别忽略 .editorconfig 和 PHP 版本匹配
即使 php-cs-fixer 配置正确，.editorconfig 中的缩进设置可能覆盖它：
- 删掉或注释掉
.editorconfig里的indent_style、indent_size，让格式化工具全权控制 - 检查 VSCode 的
php.suggest.basic是否为false（Intelephense 需启用），否则部分语法（如属性类型）可能被错误标记，干扰格式化感知 - 最关键一点：插件调用的
php命令版本，必须和你项目实际运行的 PHP 版本一致（比如项目用 PHP 8.2，但php -v输出是 7.4，match expression等新语法会被当成错误跳过）
格式化不是“装完插件点保存”就完事，路径、PHP 版本、规则文件作用域、编辑器配置四者必须对齐，缺一不可。
