vendor/bin 下的链接是符号链接，linux/macos 使用 ln -sf 创建，windows 生成 .bat 包装器；链接目标为相对于 vendor/package-name 的相对路径，不复制文件。
vendor/bin 下的链接是符号链接还是复制？
Linux/macOS 下是 ln -sf 符号链接，Windows 下生成 .bat 包装器（不是复制）。链接目标始终是相对于 vendor/package-name/ 的相对路径，例如：../phpunit/phpunit/bin/phpunit。
这意味着：
- 脚本文件本身必须存在于包内真实路径上，不能是生成的临时文件或未提交的本地修改
- 符号链接不继承权限 —— 执行权靠原文件的
+x位，不是链接本身 - Windows 的
.bat文件会硬编码调用php命令，若系统 PATH 中 php 不可用，会报'php' is not recognized
bin 字段路径解析规则是什么？
Composer 只认 "bin": ["bin/my-tool"] 这类**相对于包根目录的路径字符串**，不支持变量、通配符或绝对路径。路径末尾不能带斜杠，也不能是目录。
常见误写及后果：
-
"bin": ["bin/"]→ 忽略，不生成任何链接 -
"bin": ["MyTool::run"]→ 解析失败，静默跳过 -
"bin": ["vendor/bin/phpunit"]→ 指向错误位置，链接目标不存在，ls -l vendor/bin/phpunit显示broken -
"bin": ["scripts/deploy.php"]→ 合法，但需确保该文件存在且第一行是#!/usr/bin/env php
链接名怎么确定？冲突时如何处理？
链接名取自 bin 路径的 basename，即 bin/phpunit → vendor/bin/phpunit；tools/psalm → vendor/bin/psalm。多个包声明同名 bin 时，Composer 保留第一个安装的，后续同名项被跳过并发出警告（Skipped bin ... because it conflicts with ...）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
这导致：
- 无法靠后安装的包覆盖先安装的同名命令（比如想用新版 phpunit 替换旧版，得先卸载旧包）
-
composer show不显示冲突信息，必须看composer install -v的完整输出才能发现警告 - 手动删掉
vendor/bin/phpunit并重装不会自动恢复 —— 必须清空vendor/或运行composer update package/name
为什么 ls vendor/bin 看起来正常却执行失败？
因为链接存在 ≠ 目标可执行。最常踩的坑是：链接指向了真实文件，但该文件缺少 shebang 或执行权限。
验证三步缺一不可：
- 运行
composer show vendor/package，确认输出里有bin: bin/phpunit行 - 运行
ls -l vendor/bin/phpunit，确认链接目标路径存在且可读（如../phpunit/phpunit/bin/phpunit） - 进入目标路径，运行
head -1 ../phpunit/phpunit/bin/phpunit看是否为#!/usr/bin/env php，再运行stat -c "%a" ../phpunit/phpunit/bin/phpunit（Linux/macOS）确认权限含1（即 x 位）
Windows 用户容易忽略 .bat 文件内容是否正确 —— 它由 Composer 自动生成，但若原 PHP 脚本路径含空格或特殊字符，包装器可能生成失败，此时需手动检查 vendor/bin/phpunit.bat 内容。
