bin-dir必须在composer.json的config中配置相对路径，不可用命令行开关；需手动创建目录、删除旧vendor/bin、重装依赖，并配bin-compat: full兼容中文路径，PATH须自行添加。

composer.json里配bin-dir是唯一可靠方式

直接运行composer install --bin-dir=xxx会失败，报错Unrecognized option "--bin-dir"——这个参数在 Composer 2.x 中已被移除，命令行开关早已不生效。必须改项目根目录的composer.json，在config段写死：

{ "config": { "bin-dir": "scripts" } }

值必须是相对路径（如scripts、bin），不能以../开头，也不能是绝对路径（除非你加--no-plugins强行绕过校验，不建议）。

改完必须重装依赖，且目标目录得提前存在

bin-dir配置不会自动创建目录。如果scripts/不存在，composer install会直接报错：Could not create bin dir。所以操作顺序只能是：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 手动创建scripts/目录（mkdir scripts）
• 修改composer.json
• 删掉现有vendor/bin/（避免旧链接残留干扰）
• 执行composer install或composer update重建

注意：composer dump-autoload完全没用——它只刷新类映射，不碰二进制文件。

Windows/macOS中文路径下必加bin-compat

如果你的系统用户名含中文（比如C:\Users\张三\project），或bin-dir路径本身含中文/空格，符号链接大概率静默失败，最终scripts/里空空如也。根本原因是bin-compat默认为auto，在权限受限时 fallback 到 copy 模式，但 copy 后的.bat文件可能调用不到php.exe（PATH 未注册或路径含中文）。解决方案是在config里同时写：

"bin-dir": "scripts", "bin-compat": "full"

full强制启用兼容模式，让 Windows 生成能正确解析 php 路径的.bat，macOS/Linux 也能更稳定处理 shebang。

PATH环境变量得自己加，Composer 不会帮你

就算scripts/phpunit已生成，终端里直接敲phpunit还是报command not found——因为系统$PATH没包含它。Composer 从不修改你的 shell 环境。临时用：export PATH="./scripts:$PATH"；永久生效就加到~/.zshrc或~/.bashrc。还要注意：

• 路径必须是./scripts（相对当前项目），不是scripts/（少个点就找不到）
• 如果用了composer exec，它会自动识别bin-dir，不用额外配PATH
• IDE（如 PhpStorm）需要单独在设置里指定可执行路径，填./scripts/phpunit而不是依赖全局PATH

复杂点在于：bin-dir只控制软链/复制行为，不改变依赖包自身声明的bin字段逻辑；而某些插件（比如dealerdirect/phpcodesniffer-composer-installer）会绕过这个配置，直接往vendor/bin写文件——遇到这种情况，得查composer show --plugins确认是否冲突。