vendor/bin下二进制文件失效主因是软链接断开、未生成或路径无效，需同时满足：依赖包声明bin字段、bin-dir配置生效、调用方式匹配path或全路径；linux/macos下ls -l可查链接目标是否存在，windows下.bat硬编码php路径易失效，ci/docker中常见属主权限问题。
vendor/bin 下的二进制文件（如 phpunit、psalm）突然失效，90% 不是命令写错，而是软链接断了、没生成、或指向了不存在的路径——不是“装了就该有”，而是三件事必须同时成立：bin 字段声明 + bin-dir 配置生效 + PATH 或调用方式匹配。
为什么 vendor/bin/phpunit 显示 “No such file or directory”？
这不是文件真丢了，而是符号链接目标无效。Linux/macOS 下 vendor/bin/phpunit 是个软链，ls -l vendor/bin/phpunit 会显示类似 phpunit -> ../phpunit/phpunit/phpunit；如果右边路径不存在（比如包没装、被删、或 composer install --no-dev 跳过了），终端就会报这个错。
- 先确认是否安装了含
bin的包：composer show phpunit/phpunit看输出里有没有bin:行；没有就说明根本没装它 - 检查
vendor/phpunit/phpunit/composer.json是否真有"bin": ["phpunit"]—— 不是你的项目 composer.json 决定的，是那个包自己声明的 - 运行
ls -l vendor/bin/phpunit，看箭头右边路径是否存在；若显示broken或No such file，说明源包目录缺失 - 别信
ls vendor/bin列表——它只告诉你链接文件在，不保证能跳过去
软链接被 Composer 自动删掉或变成真实目录？
这是 Composer 的默认行为：每次 composer install 或 update 都会清空 vendor/ 目录再重建。任何你手动创建的软链接（比如 ln -s ~/my-local-package vendor/my-vendor/my-pkg）都会被一并抹掉。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果你依赖本地开发包，必须用
path类型仓库，而不是手建软链："repositories": [{"type": "path", "url": "../my-local-package"}]，再require它的 dev 版本 - 手动 ln 后又跑
composer install，链接必丢；想保留，得把 ln 命令写进post-install-cmd脚本钩子里 - 某些 CI 环境（如 GitHub Actions）用缓存解压
vendor/，若缓存里混入了手建软链，下次 install 就会覆盖成真实目录，导致 autoload 失效
Windows 下 vendor/bin/*.bat 执行失败或找不到 php？
Composer 在 Windows 上为每个 bin 生成 .bat 文件，但它的第一行硬编码了 @php 或绝对路径（如 C:\php\php.exe），一旦 PHP 安装位置变了，或者你在 WSL 里运行，就会失败。
- 打开
vendor/bin/phpunit.bat，看第一行是不是@php "%~dp0/../phpunit/phpunit/phpunit" %*；如果不是，说明包发布时用了旧版 Composer，或没适配 Windows - 不要依赖系统 PATH 里的
php——.bat文件不查 PATH，它只认自己写的路径；改的话要同步改所有.bat，不推荐 - 更稳的方式是用
composer exec phpunit：它绕过 .bat，直接调用 PHP 解释器执行目标脚本，还能透传参数（如--filter=testName） - 确保
composer exec可用：需要 Composer ≥ 2.2，且项目里已正确生成vendor/bin或自定义bin-dir
CI 或 Docker 里 vendor/bin 命令突然报 Permission denied
这通常不是权限位（chmod）问题，而是属主错了——容器内以 UID 1001 运行，但 vendor/ 是宿主机 root 用户生成的，导致容器无权读写。
- 执行
ls -ld vendor，如果输出是drwxr-xr-x 12 root root，就是它；chmod +x没用，得chown -R 1001:1001 vendor（Docker 中对应 UID） - Docker 构建时避免挂载整个项目目录后直接
composer install；应该先在容器内以非 root 用户初始化 vendor，或用 multi-stage 构建分离构建与运行阶段 - GitHub Actions 缓存
vendor/时，解压后默认继承归档时的 UID；加一步chown -R $USER:$USER vendor或干脆rm -rf vendor && composer install - 别忽略
composer.lock的归属：如果它也是 root 所有，composer install会因无法写 lock 文件而卡住
真正容易被忽略的是：软链接失效从来不是孤立事件，它背后总连着一个配置断点——要么包没声明 bin，要么 bin-dir 被覆盖却没清理旧目录，要么 PATH 没包含新位置，要么执行环境（Windows/WSL/Docker）让 .bat 或符号链接失能。验证时永远从源头开始：先看包本身有没有 bin，再看链接是否存在且有效，最后才查调用方式。
