VS Code终端运行PHP脚本需确保php命令可用且路径正确：先验证php -v，再执行php script.php；Windows需加PATH，macOS/Linux需配置shell环境文件，调试用php -r快速验证。
VS Code 里用终端运行 PHP 脚本，核心就两点：终端能调用 php 命令，且脚本路径写对。不是装了 PHP 就自动可用，常见问题是终端报错 Command 'php' not found 或 Bad file descriptor。
确认系统已安装 PHP 并加入 PATH
VS Code 终端（无论 Windows PowerShell、macOS zsh 还是 Linux bash）默认继承系统环境变量。如果在系统终端（如 macOS Terminal、Windows CMD）里执行 php -v 报错，VS Code 终端也一样会失败。
- Windows 用户：安装 PHP 后务必勾选「Add PHP to PATH」，或手动把 PHP 安装目录（如
C:\php）加进系统环境变量PATH - macOS 使用 Homebrew 安装：运行
brew install php后，Homebrew 通常会提示你把/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel）加入 shell 配置文件（~/.zshrc），别跳过这步 - Linux（Ubuntu/Debian）：用
sudo apt install php-cli，不是只装php包——php-cli才提供命令行可执行文件php
在 VS Code 终端中执行 PHP 脚本的正确写法
打开 VS Code，确保当前工作区是脚本所在目录（或使用绝对/相对路径）。终端命令格式统一为：php script.php，不加 ./（PHP 不是可执行文件，不依赖 shebang 或 chmod +x）。
- 脚本在当前目录：直接运行
php index.php - 脚本在子目录：用相对路径，如
php src/main.php - 带参数：参数跟在脚本名后，如
php process.php --input data.json -v，PHP 脚本内通过$argv获取 - 注意不要写成
php ./index.php—— 虽然多数情况也能跑，但./在 Windows 终端下可能触发权限错误；也不要用php \path\to\script.php（反斜杠在 PowerShell 中需转义，易出错）
VS Code 终端启动后仍找不到 php 的典型原因
即使系统 PATH 正确，VS Code 终端也可能“看不见” PHP——尤其在 macOS/Linux 下，因为 VS Code 可能没加载你的 shell 配置（如 ~/.zshrc）。
立即学习“PHP免费学习笔记（深入）”；
- 检查终端类型：VS Code 底部状态栏点终端右上角小箭头，确认当前终端是
zsh、bash还是PowerShell；不同 shell 读取的配置文件不同（zsh读~/.zshrc，bash读~/.bash_profile） - 临时修复：在 VS Code 终端里手动执行
source ~/.zshrc（或对应配置文件），再试php -v - 永久解决：在 VS Code 设置里搜索
terminal integrated default profile，找到对应终端的设置项，勾选「Run command on startup」并填入source ~/.zshrc（macOS）或. ~/.bash_profile（Linux） - Windows 用户若用 Git Bash，确保安装时勾选了「Use Windows’ default console window」，否则 PATH 可能未同步
调试时推荐的最小可行命令组合
快速验证环境是否 ready，避免在复杂项目里反复碰壁：
php -r "echo 'PHP is working';"
这个命令不依赖任何文件，纯靠 PHP 解释器执行字符串。如果它失败，说明根本问题在 PHP 安装或 PATH；如果成功，再试本地脚本。
- 接着试一个最简脚本：
echo " test.php（Linux/macOS），然后php test.php - Windows 用户用
echo ^ test.php创建文件（^是 cmd 转义符） - 如果
php -r成功但php test.php失败，大概率是文件编码问题（别用 BOM）、换行符（CRLF 可能在某些 PHP 版本报 warning）、或脚本里用了 Web 环境函数（如$_SERVER['REQUEST_URI']）
真正卡住的地方往往不在 VS Code 本身，而在 shell 初始化逻辑和 PHP 的 CLI 模式与 Web 模式的差异。先让 php -r 跑通，再逐步加文件、加参数、加依赖——顺序错了，排查成本会翻倍。
