如何在VSCode代码格式化中保持PHP起始标签左对齐？

AI 小北

2026-7-23

解决VSCode中Intelephense格式化时PHP起始标签顶格的问题

要让所有PHP起始标签<?php保持无缩进顶格，同时正常格式化其余代码，可按以下步骤配置Intelephense：

1. 确保Intelephense为默认PHP格式化程序

打开VSCode设置（快捷键Ctrl+, / Cmd+,），搜索default formatter，找到PHP对应的默认格式化程序，选择bmewburn.vscode-intelephense-client。

2. 修改Intelephense格式化配置

打开VSCode的JSON配置文件（通过Ctrl+Shift+P输入Open Settings (JSON)打开），添加或修改以下配置：

"intelephense.format": {
    "indentation": {
        "tags": false
    },
    // 可选：保持你习惯的其他格式化规则，比如缩进级别
    "indentationLevel": 4,
    "braces": "k&r"
}

indentation.tags: false 会强制PHP起始标签不继承父级缩进，保持顶格显示。
其余配置可根据你的代码风格调整，比如indentationLevel设置缩进的空格数。

3. 验证效果

保存配置后，打开你的PHP文件，使用Shift+Alt+F触发格式化，就能看到所有<?php标签自动顶格，内部代码仍保持正常缩进，符合你期望的效果。

备选方案（若Intelephense配置不生效）

如果上述配置无法满足需求，可改用PHP-CS-Fixer实现自定义规则：

安装VSCode的PHP CS Fixer插件。
在项目根目录创建.php-cs-fixer.dist.php文件，添加以下规则：

$finder = PhpCsFixer\Finder::create()
    ->in(__DIR__);

return (new PhpCsFixer\Config())
    ->setRules([
        '@PSR12' => true,
        'no_indented_php_tag' => true, // 核心规则：禁止PHP标签缩进
        'indentation_level' => 4
    ])
    ->setFinder($finder);