根本原因是Windows找不到php.exe，因PHP安装目录未正确添加到系统Path环境变量中；需确认php.exe真实路径、不带尾部反斜杠地添加至Path，重启CMD并用where php验证。
为什么 CMD 里输入 php 报 “not recognized”
根本原因只有一个：Windows 找不到 php.exe。系统只在 Path 环境变量列出的目录里搜可执行文件，而你装好的 PHP 目录没加进去，或者加错了。
常见错觉是“我已经装了 XAMPP / WAMP / phpStudy”，但这些集成环境默认不自动注册到全局 Path —— 它们只在自己的控制面板或服务里用，CMD 不认。
验证方法很简单：打开 CMD，直接输 where php。如果返回空，说明系统完全不知道 php.exe 在哪；如果有路径，就说明已注册，问题可能出在其他地方（比如路径带空格、权限、或 Shell 加载逻辑）。
怎么正确添加 PHP 到系统 Path
关键不是“加对了没”，而是“加得干净、无歧义、可验证”：
立即学习“PHP免费学习笔记（深入）”；
- 先确认
php.exe的真实位置，比如C:\php或E:\myphp_www\PHPTutorial\php\php-5.4.45，进该目录手动双击运行一下php.exe，确保它真能启动（不闪退） - 复制整个目录路径，**不带
php.exe，也不加尾部反斜杠**（C:\php\错，C:\php对） - 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」→ 在「系统变量」中找到
Path→「编辑」→「新建」→ 粘贴路径 -
Path里多个条目用英文分号;分隔，不要混入中文标点或换行 - 保存后，**必须关闭所有已打开的 CMD 窗口，再新开一个**——旧窗口不会自动重读
Path
为什么重启电脑有时才生效
不是系统非要重启，而是某些程序（比如 Cursor、Sublime Text、VS Code）在启动时只读一次 Path，之后哪怕你改了环境变量，它们也不会刷新。这类工具的进程常驻后台，你以为关了窗口，其实 cursor.exe 或 Code.exe 还在托盘跑着。
解决办法比重启更轻量：
- 打开任务管理器 → 「详细信息」选项卡 → 结束所有
cursor.exe、Code.exe、subl.exe等相关进程 - 再重新从开始菜单或桌面图标启动编辑器
- 在编辑器里新开终端（Terminal），运行
php -v验证
特别注意：macOS 上用 Spotlight 或 Dock 启动 Sublime/VS Code，它压根不加载 shell 的 PATH（比如 ~/.zshrc 里的配置），必须用终端命令 open -a "Visual Studio Code" 启动才能继承环境变量。
路径含空格导致 php think run 失败
ThinkPHP 的 php think run 命令底层调用的是 php -S 内置服务器，一旦 PHP 安装路径含空格（比如 D:\Program Files\php），CMD 就会把 D:\Program 当成一个独立命令，报错 'D:\Program' is not recognized。
这不是环境变量配置错了，而是命令拼接时没加引号。临时绕过方法：
- 把 PHP 移到无空格路径，如
C:\php，然后重新配Path - 如果必须放带空格路径，修改 ThinkPHP 源码中拼命令的地方（如
vendor/topthink/framework/src/think/console/command/RunServer.php第 59 行），把'%s -S ...'改成'"%s" -S ...'，让php.exe路径被双引号包裹 - 不建议长期硬编码
php.executablePath到编辑器设置里，这会让项目迁移或协作时路径失效，且掩盖了根本的环境变量问题
最稳的做法，永远是让 php.exe 路径本身不含空格，并确保它干净地落在 Path 里——后续所有工具、脚本、框架都依赖这个基础。
