CMD中运行php报“不是内部或外部命令”，主因是phpenv未被正确加载进当前CMD的PATH，且CMD作为非登录shell不读取bash/zsh配置，phpenv官方也不原生支持Windows。
phpenv 本身不负责设置系统级环境变量，它只管理 PHP 可执行文件的软链接和 PATH 路径切换；在 Windows CMD 中直接执行 php 命令失败，90% 是因为 phpenv 没被正确加载进当前 CMD 的 PATH，或根本没生效。
为什么 cmd 里运行 php 报“不是内部或外部命令”
Windows 下的 CMD 是非登录 shell，不会自动读取 ~/.bashrc 或 ~/.zshrc；即使你按 Linux 方式配置了 phpenv（比如写入 ~/.bashrc），CMD 完全看不到这些配置。另外，phpenv 官方本身也不支持原生 Windows，所谓“Windows 上用 phpenv”基本是靠 WSL、Git Bash 或第三方移植版（如 phpenv-win）模拟的。
常见错误现象：
- 在 CMD 中输入
phpenv提示“命令未找到” - 输入
php -v显示旧版本（比如 PHP 7.4），而非phpenv global 8.2设定的版本 - 用 Git Bash 能正常切换 PHP 版本，但切换到 CMD 就失效
在 Windows 上让 php 命令在 CMD 中可用的实操路径
别绕弯子，直接走最可控的路：手动把目标 PHP 版本的 php.exe 所在目录加进系统 PATH，和 phpenv 是否运行无关。
立即学习“PHP免费学习笔记（深入）”；
- 先确认你要用的 PHP 版本安装在哪，例如：
D:\phpEnv\php\php-8.2\（注意末尾无反斜杠） - Win+R → 输入
sysdm.cpl→ “高级” → “环境变量” → 在“系统变量”中双击Path - 点击“新建”，粘贴上面那个完整路径（不要带空格、不要引号）
- 删掉其他冲突的 PHP 路径（比如
D:\phpEnv\php\php-7.4\） - 关闭所有 CMD 窗口，新开一个，运行
php -v验证
这个操作绕过了 phpenv 的 shell hook 机制，但对 CMD 来说最稳定。如果你坚持要用 phpenv 切换 CMD 中的 PHP，必须用支持 Windows 的 fork 版本（如 phpenv-win），并确保其 bin 目录也在 PATH 中，且初始化脚本（如 phpenv.bat）被调用过。
getenv() 读不到你在 CMD 里 set PHP_ENV=dev 设的变量？
因为 CMD 中用 set VAR=value 设置的是“会话级变量”，只对当前 CMD 及其子进程有效；但 PHP CLI 进程启动时若没显式继承，就拿不到。更麻烦的是：PHP 默认不从 $_ENV 读，而 getenv('PHP_ENV') 是否返回值，取决于变量是否真被注入到进程环境。
- 临时测试：在 CMD 中先运行
set PHP_ENV=dev && php -r "var_dump(getenv('PHP_ENV'));"—— 注意&&保证在同一 shell 会话 - 持久化方案：把
set PHP_ENV=dev加到%USERPROFILE%\phpenv-init.bat，再让每次打开 CMD 自动运行它（通过注册表或 CMD 的AutoRun配置） - Web 场景下别依赖 CMD 设置：Apache 用
SetEnv，Nginx 用fastcgi_param，PHP-FPM 在 pool 配置里写env[PHP_ENV] = dev
Linux/macOS 下 phpenv 和环境变量的真实关系
phpenv 不设置 PHP_ENV 这类业务变量，它只改 PATH 和 PHP_VERSION 这类运行时元信息。你执行 phpenv global 8.2 后，实际发生的是：
- 在
~/.phpenv/versions/下找8.2对应的完整路径 - 在
~/.phpenv/shims/php创建指向该路径下php的符号链接 - 你的 shell 的
PATH包含~/.phpenv/shims，所以敲php时优先命中 shims
所以：业务环境变量（如 APP_ENV、DB_HOST）必须由你主动注入，phpenv 不代劳。最简方式是在运行 PHP 命令前用 export APP_ENV=local，或封装成脚本：APP_ENV=local php artisan serve。
容易被忽略的一点：PHP CLI 进程默认不加载用户 profile（如 ~/.bash_profile），所以 export 写在那里面，对非登录 shell（如 VS Code 终端开的 bash）可能不生效——得写进 ~/.bashrc 或用 source ~/.bash_profile 显式加载。
