根本原因是Windows PATH环境变量中存在多个同名.bat文件，系统按顺序匹配时优先调用了错误路径下的laravel.bat或phpunit.bat，导致命令不可用或执行异常。
为什么直接敲 laravel 或 phpunit 会报“不是内部或外部命令”
根本原因不是 Composer 没装好，而是 Windows 找到的不是你期望的那个 .bat 文件——它在 PATH 里撞车了。系统按顺序扫描 PATH，一旦遇到第一个叫 laravel.bat 的文件就执行，哪怕它路径错、内容空、甚至指向一个已删掉的 PHP 版本。
常见错误现象：
• 在 CMD/PowerShell 里运行 laravel 报错：'laravel' 不是内部或外部命令...
• where laravel 输出多行，第一行指向 XAMPP\php\ 或 OpenServer\modules\php\ 下的旧批处理
• 进入 %APPDATA%\Composer\vendor\bin\ 目录双击 laravel.bat 能运行，但命令行调用失败
- 用
where laravel查所有匹配项，定位“抢跑”的那个路径 - 去系统环境变量（用户 + 系统两级）里，删掉所有含
php\子目录的PATH条目（尤其是 XAMPP/WAMP/OpenServer 自带的） - 只保留一条干净的 Composer bin 路径，例如：
%APPDATA%\Composer\vendor\bin，且把它放在PATH最开头 - 删完后关掉所有终端，新开一个再试 —— 旧终端进程不会自动刷新
PATH
composer.json scripts 里调用 phpunit 为什么 CI 总失败
CI 环境（如 GitHub Actions、GitLab CI）默认不把 vendor/bin 加进 PATH，裸写 "test": "phpunit" 必然报 command not found。这不是权限问题，也不是没装包，是路径根本没被识别。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 永远用相对路径：
"test": "./vendor/bin/phpunit --testdox"（注意开头的./） - 不要拼
{$bin-dir}或$(composer config bin-dir)—— Composer 没这个变量，Windows 下还容易因空格炸掉 - 所有脚本都这么写，
phpcs、phpstan、pest全部统一前缀./vendor/bin/ - Windows 下
./vendor/bin/phpunit实际执行的是phpunit.bat，Linux/macOS 下是 shell 脚本 ——./写法自动适配，不用判断系统
为什么改了 bin-dir 还是调不到新位置的 .bat
Composer 默认把可执行文件复制/链接到 bin-dir（通常是 %APPDATA%\Composer\vendor\bin），但如果你手动改过这个路径，比如设成 D:\bin，后续却没清理旧路径里的同名 .bat，就会出现“两个 phpunit.bat 同时存在，系统总调错那个”。更麻烦的是，某些旧版 Composer 安装器会在注册表里偷偷写 PATH，升级后也不清理。
- 先查当前生效路径：
composer config --global bin-dir - 用
where phpunit看实际被调用的是哪个文件 - 检查注册表两项：
HKEY_CURRENT_USER\Environment\PATH和HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment\PATH，删掉重复或失效的条目 - 禁用 Composer 自动改 PATH：安装时取消勾选 “Add to PATH”，之后全靠你手动管
双击 laravel.bat 没反应？别急着重装
这通常不是 Composer 的锅，是 Windows 批处理关联损坏或权限卡住。双击无反应 ≠ 文件坏了，大概率是系统层面拦截了执行。
- 右键
laravel.bat→ “以管理员身份运行”，看是否弹窗报错（比如找不到php.exe） - 用 PowerShell（管理员）执行这两行修复关联：
cmd /c assoc .bat=batfilecmd /c ftype batfile="%1" %* - 确保该
.bat文件路径不含中文、空格、括号；若必须放这种路径，调用时加双引号："C:\my tools\laravel.bat" - 检查它开头的
@php行是否指向真实存在的 PHP 可执行文件 ——where php能帮你确认
最常被忽略的一点：你以为你在调 Composer 装的 laravel，其实系统早就从 OpenServer 的 PHP 目录里拉了个半成品 laravel.bat 出来执行了。PATH 冲突不解决，换多少版本都没用。
