composer.json 中通过 config.bin-dir 字段可修改 bin 目录，默认为 vendor/bin，设为 "scripts" 后需运行 composer install/update 生效；项目级配置优先于全局，路径需手动加入 path 或显式调用。
composer.json 里怎么改 bin-dir
默认情况下，Composer 把可执行脚本（比如 phpunit、larastan）软链接到项目根目录下的 vendor/bin。想换位置，直接在 composer.json 的 config 段写死就行：
示例配置：
{
"config": {
"bin-dir": "scripts"
}
}
改完必须运行 composer install 或 composer update 才生效——光改 JSON 不重建链接，旧的 vendor/bin 还在，新的目录也不会自动创建。
常见错误现象：composer install 后发现 scripts 目录空着，或者命令仍从 vendor/bin 调用：多半是没重装依赖，或被全局 bin-dir 配置覆盖了。
全局 config 和项目 config 哪个优先级高
项目级 composer.json 的 config.bin-dir 会覆盖全局配置，但前提是它确实存在且语法正确。如果项目里没写，Composer 就回落到全局设置；全局也没设，才用默认的 vendor/bin。
查当前生效值，运行：composer config bin-dir（不加 -g 查项目级，加 -g 查全局）。
容易踩的坑：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 误在全局配了
bin-dir，结果所有项目都受影响，CI 构建失败却查不到原因 - 用
composer config bin-dir scripts（没加-g）想改项目配置，实际改的是当前目录下的composer.json——但如果当前不是项目根目录，就写错地方了 - 路径写成相对路径如
../bin，某些系统或 CI 环境下符号链接会失效
Windows 下 vendor/bin 本质是 .bat 文件，不是软链
Linux/macOS 上 vendor/bin 里的文件是符号链接，指向 vendor/{vendor}/{package}/bin/xxx；Windows 没法可靠做软链，Composer 改用生成 .bat 和 .sh 包装脚本。所以你改 bin-dir，Windows 上实际生成的是 scripts/xxx.bat，内容是调用 PHP 解释器去跑原脚本。
这意味着：
- 不能指望 Windows 上的
scripts/xxx直接可执行（没扩展名），得敲scripts/xxx.bat或加.bat到PATHEXT - 某些 IDE 或 shell 补全不识别这种包装脚本，提示“command not found”
- 如果原包没提供
bin字段（比如只靠autoload.files注册函数），改bin-dir也无济于事
bin-dir 改了，PATH 怎么跟上
改完 bin-dir 只影响 Composer 自己生成的链接或脚本位置，不影响系统 PATH。你得手动把新路径加进环境变量，否则终端里还是找不到命令。
比如设成 "bin-dir": "tools"，就得确保 $PWD/tools（Linux/macOS）或 %CD%\tools（Windows）在 PATH 里。
更现实的做法是：
- 开发时用
./tools/xxx显式调用（避免 PATH 问题） - CI 中用绝对路径，比如
${{ github.workspace }}/tools/phpunit - 别依赖全局 PATH，尤其当多个项目 bin-dir 不一致时，PATH 很容易冲突
最常被忽略的一点：很多团队改了 bin-dir 却忘了同步更新文档、CI 脚本、IDE 的外部工具配置——结果本地能跑，CI 报错，排查半天发现只是路径写死了 vendor/bin。
