必须清缓存、删 vendor 后重装才生效；项目配置优先于全局，路径须为相对路径；PATH 未更新则命令仍不可用；Windows 下应避免空格/中文路径。
改 bin-dir 不是改完配置就立刻生效，必须清空 vendor 后重装依赖，否则旧文件还在 vendor/bin，新目录永远空着。
怎么在项目里正确设置 bin-dir
直接编辑项目根目录的 composer.json，在 config 段加字段：
{
"config": {
"bin-dir": "bin"
}
}
注意三点：
-
bin-dir值必须是相对路径（如"bin"、"scripts"），不能以/开头，也不能写./bin或绝对路径 - 目录无需提前创建，Composer 安装时会自动建
- 改完不运行命令，配置只是存着，不会触发任何文件移动或链接生成
composer install 后 bin 目录还是空的？
这是最常见误判点：你以为改了就该出文件，其实 bin-dir 只影响「新安装/更新」的包，对已存在的 vendor/ 完全无感。现象是 vendor/bin 里一堆脚本，你设的 bin/ 却空空如也。
正确做法是：
- 先运行
composer clear-cache，避免旧缓存干扰 - 手动删掉整个
vendor/目录（别只删vendor/bin） - 再执行
composer install—— 这时才会按新bin-dir生成符号链接或.bat文件 - 如果设的是
"bin-dir": "tools"，确保tools/目录可写，否则会静默失败，连报错都没有
为什么终端敲 phpunit 还是找不到命令？
bin-dir 只管“放哪”，不管“怎么调用”。系统不认识命令，99% 是因为 $PATH 没包含你的新目录。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
临时解决（当前终端有效）：
- Linux/macOS：
export PATH="$(pwd)/bin:$PATH" - Windows CMD：
set PATH=%cd%\bin;%PATH%
长期方案要写进 shell 配置（如 ~/.zshrc），但注意协作项目中别用 $(pwd) 这种动态路径——别人 clone 下来就失效。更稳妥的是用绝对路径，比如 export PATH="/home/user/myproject/bin:$PATH"。
额外提醒：
- Windows 下生成的是
bin/phpunit.bat，不是可执行文件，得敲phpunit.bat或把.BAT加进PATHEXT - IDE（如 PHPStorm、VS Code）启动时可能没读你的
PATH修改，需要重启 IDE 或单独配环境变量 - 某些包（如靠
post-install-cmd复制二进制的）可能绕过bin-dir，验证方式：删干净vendor后重装，看文件到底落在哪
全局配置 vs 项目配置，哪个起作用？
项目级 composer.json 中的 config.bin-dir 永远优先于全局配置。你在项目根目录下运行 composer config bin-dir scripts，它会写进本地 composer.json；而 composer config --global bin-dir /usr/local/bin 几乎没用——Composer 不会用它覆盖项目配置，且全局设置对项目内安装行为零影响。
所以：
- 团队统一规范？直接在项目
composer.json里写死"bin-dir": "bin" - 个人调试多个项目？才考虑全局配置，但别指向
/usr/local/bin这类系统路径，权限和冲突风险高 - 检查当前生效值？进项目根目录后运行
composer config bin-dir，输出才是真实值
真正容易被忽略的是：改了 bin-dir 后，所有依赖包的二进制入口都挪了位置，但 composer exec 仍能自动找到它们——这个命令内部会查 bin-dir 配置，不用你操心路径。其他所有调用方式，都得自己搞定 PATH 和执行权限。
