VS Code启动报Error spawning PHP错误，路径正确却无法识别求解决

错误信息 #

启动VS Code后持续弹出以下错误：

Error spawning PHP: Command failed with exit code 1: C:\laragon\bin\php\php-8.1.2-Win32-vs16-x64 --version 'C:\laragon\bin\php\php-8.1.2-Win32-vs16-x64' is not recognized as an internal or external command, operable program or batch file.

用户配置文件 #

当前VS Code的settings.json配置如下：

{
    "editor.fontSize": 18,
    "blade.format.enable": true,
    "phpformatter.composer": true,
    "[php]": {
        "editor.defaultFormatter": "kokororin.vscode-phpfmt"
    },
    "php.validate.executablePath": "C:\\laragon\\bin\\php\\php-8.1.2-Win32-vs16-x64",
    "workbench.colorTheme": "Atom One Dark",
    "terminal.integrated.fontSize": 16,
    "markdown.preview.fontSize": 21,
    "debug.console.fontSize": 21,
    "editor.suggestFontSize": 21,
    "editor.fontWeight": "300",
    "git.autofetch": true,
    "workbench.iconTheme": "material-icon-theme",
    "editor.codeActionsOnSave": null,
    "[html]": {
        "editor.defaultFormatter": "esbenp.prettier-vscode"
    },
    "[vue]": {
        "editor.defaultFormatter": "octref.vetur"
    },
    "[css]": {
        "editor.defaultFormatter": "esbenp.prettier-vscode"
    },
    "tabnine.experimentalAutoImports": true,
    "bracketPairColorizer.depreciation-notice": false,
    "phpcs.executablePath": "C:\\Users\\user\\AppData\\Roaming\\Composer\\vendor\\bin\\phpcs.bat",
    "phpcs.enable": false,
    "phpcs.showWarnings": false,
    "workbench.startupEditor": "none",
    "window.zoomLevel": 2,
    "security.workspace.trust.untrustedFiles": "open",
    "php.executablePath": "C:\\laragon\\bin\\php\\php-8.1.2-Win32-vs16-x64",
    "php.debug.executablePath": ""
}

问题原因 #

• 路径指向错误：配置中的PHP路径指向的是PHP安装目录，而非具体的php.exe可执行文件，系统无法将目录作为命令执行，因此报错。
• 插件触发验证：VS Code中的PHP相关插件（如phpfmt、PHP验证工具）会在启动时读取配置的PHP路径并尝试执行验证命令，错误的路径直接触发了执行失败。

解决方法 #

1. 修正配置中的PHP路径 #

打开VS Code的设置文件（按Ctrl+Shift+P，输入Preferences: Open Settings (JSON)），将php.validate.executablePath和php.executablePath修改为指向php.exe的完整路径：

"php.validate.executablePath": "C:\\laragon\\bin\\php\\php-8.1.2-Win32-vs16-x64\\php.exe",
"php.executablePath": "C:\\laragon\\bin\\php\\php-8.1.2-Win32-vs16-x64\\php.exe"

2. 重启插件与VS Code #

• 打开扩展面板（按Ctrl+Shift+X），找到所有PHP相关插件（如kokororin.vscode-phpfmt、PHP IntelliSense），点击插件卡片右下角的「重新加载」按钮。
• 完全关闭VS Code后重新启动，检查错误是否消失。

3. 可选：添加PHP路径到系统环境变量 #

为了避免后续其他工具出现类似路径问题，可将PHP安装目录添加到系统PATH：

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在系统变量的Path列表中添加C:\laragon\bin\php\php-8.1.2-Win32-vs16-x64，保存设置。
• 重启VS Code后，配置中的PHP路径可简化为php.exe，无需完整绝对路径。

内容的提问来源于stack exchange，提问作者Benny