根本原因是Windows下vendor/bin/*.bat脚本硬编码调用php命令，不查PATH且无法处理含空格路径，导致'php is not recognized'；解决方法是设"bin-compat":"proxy"并用php vendor/bin/phpunit显式调用。
vendor/bin 下的命令为什么在 Windows 上执行失败？
根本原因不是 PHP 没装好，而是 vendor/bin/phpunit 这类文件在 "bin-compat": "full"（默认）下生成的是 .bat 脚本，它硬编码调用 php 命令，不查 PATH，也不处理含空格路径（如 C:\Program Files\php\php.exe）。你看到的 'php' is not recognized 错误，就是 CMD 执行这个 .bat 时直接失败。
解决思路不是改系统环境变量，而是绕过 .bat：
- 显式设
"bin-compat": "proxy"，让 Composer 只生成无扩展名的 PHP 代理文件（如vendor/bin/phpunit），必须用php vendor/bin/phpunit调用 —— 这样就完全由你当前的php可执行文件决定行为，路径、版本、INI 都可控 - 改完后必须运行
composer install或composer update，否则旧.bat文件不会被替换 - Linux/macOS/WSL 用户重装后要手动补权限：
chmod +x vendor/bin/*，否则代理文件不可执行
想把 phpunit 放进 ./tools/ 而不是 vendor/bin，怎么配才真生效？
config.bin-dir 确实能控制依赖包二进制脚本的符号链接位置，但它不替代 vendor/bin，只是多一层映射。它只对「依赖包自身声明了 bin 字段」的工具起作用（比如 phpunit/phpunit 的 "bin": ["phpunit"]）。
配置步骤很明确：
- 在项目
composer.json的config块里加："bin-dir": "tools" - 确保目录存在：
mkdir -p tools（虽然 Composer 通常会自动建，但 Windows 下防病毒软件可能拦截创建） - 运行
composer install—— 此时tools/phpunit会指向vendor/bin/phpunit（Linux/macOS）或复制一份.bat（Windows） -
vendor/bin/依然存在且被写入，这是 Composer 硬编码行为，无法禁用
注意：bin-dir 对项目自己声明的 bin（如 "bin": ["bin/deploy"]）也生效，但前提是该脚本真实存在且有可执行权限（chmod +x 或 Windows 下带 .bat/.php 后缀）。
为什么改了 bin-dir 还是不能直接敲 phpunit？
因为终端找不到命令 —— bin-dir 只管“放哪”，不管“怎么认”。系统 $PATH 里没有你的 ./tools，自然不认识 phpunit。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
临时方案（开发机）：export PATH="./tools:$PATH"，仅当前 shell 有效；重启终端或 IDE 就失效。
长期方案不推荐写死绝对路径（协作项目会挂），更可靠的做法是：
- CI/CD 脚本里别写
./tools/phpunit，统一用composer exec phpunit—— 它自动定位、保证用项目锁死的 PHP 版本和 autoloader - 本地开发若坚持直调，把
$(pwd)/tools加进~/.zshrc（macOS/Linux）或系统环境变量（Windows），但需提醒团队成员同步 - 永远别依赖
vendor/bin出现在$PATH里 —— 它是临时产物，重装可能重建，且不同项目路径冲突
自己写的 bin 脚本怎么确保跨平台可用？
关键不在语言，而在入口契约。一个 bin/deploy 要被 Composer 正确识别并执行，必须满足三个条件：
- 路径写进
composer.json的bin数组："bin": ["bin/deploy"] - 文件真实存在，且第一行是 shebang：
#!/usr/bin/env php（PHP 脚本）或#!/bin/bash（Shell 脚本）；Windows 不依赖 shebang，但建议保留，WSL 下有用 - Unix 系统下必须有执行权限：
chmod +x bin/deploy；Windows 下可接受.php后缀，但推荐不加后缀 + shebang，保持与 Linux 一致
脚本内部别假设 vendor/autoload.php 存在 —— composer scripts 默认不加载 autoloader。安全写法是显式 require __DIR__ . '/../vendor/autoload.php';，并加 CLI 环境判断：
#!/usr/bin/env php
<?php
if (PHP_SAPI !== 'cli') {
exit('This script must be run from the command line' . PHP_EOL);
}
require __DIR__ . '/../vendor/autoload.php';
// 启动逻辑...
真正容易被忽略的是：改了 bin 数组或脚本内容后，不运行 composer install，vendor/bin/ 或 tools/ 下的链接/副本就不会更新 —— 这不是缓存问题，是 Composer 的生成机制本身要求重装触发。
