composer的scripts字段不跨平台适配，linux命令如cp、rm在windows上直接报错；应改用php脚本或平台无关命令（如"test": "php vendor/bin/phpunit"），避免在post-install-cmd中使用chmod +x等posix专属命令。
scripts字段里写了Linux命令，Windows上直接报错
Composer 的 scripts 字段是纯 shell 命令，它不做任何跨平台适配。你在 composer.json 里写 "post-install-cmd": "cp -r src/ dist/"，Linux/macOS 下能跑，Windows CMD 或 PowerShell 里就报“'cp' 不是内部或外部命令”。这不是 Composer 的 bug，是它根本没义务翻译命令。
常见失效命令包括：cp、rm -rf、ls、grep、sed、ln -sf；路径分隔符用反斜杠 \ 或混用 / 和 \ 也会在 Git Bash 或 WSL 中因换行符（CRLF/LF）或 shell 解析差异出问题。
- 开发阶段：统一改用 PHP 脚本替代 shell 命令，比如用
php -r "copy('src/file', 'dist/file');" - CI/CD 阶段：明确限定执行环境（如 GitHub Actions 用
ubuntu-latest），避免混用 Windows runner - 若必须保留 shell，加平台判断：用
if [ "$(uname)" = "Linux" ]; then ... fi（仅限 POSIX 系统），但别指望它在 Windows 上生效
vendor/bin/脚本在Windows下找不到命令
Linux/macOS 的 bin 脚本靠 shebang 行（如 #!/usr/bin/env php）启动，Windows 完全忽略这行。Composer 不会自动为 Unix 风格的 bin/phpunit 生成 .bat 包装器——这事得包作者自己做（比如 symfony/console 就提供了）。
结果就是：你在 Windows 上直接运行 vendor/bin/phpunit，CMD 报“不是内部或外部命令”，PowerShell 可能提示“无法加载文件，因为在此系统上禁止运行脚本”（执行策略限制）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 临时解法：显式用
php vendor/bin/phpunit，绕过 shebang 和权限检查 - 长期做法：在
composer.json的scripts里定义平台无关命令，如"test": "php vendor/bin/phpunit" - 确认上游是否提供 Windows 兼容入口：查看包的 GitHub 仓库，
bin/目录下是否有phpunit.bat或phpunit.cmd
chmod +x 在 post-install-cmd 里无效，还可能报错
post-install-cmd 是个陷阱区：你加了 "chmod +x vendor/bin/*"，Linux 下看似正常，但一旦进到 Windows CI（比如 GitHub Actions 的 windows-latest），这个命令根本不存在，整个 install 流程就中断。
更隐蔽的问题是：即使你在 Linux 环境跑成功了，chmod +x vendor/bin/* 只影响当前机器，下次 CI 拉新镜像重装，又得重复一遍——它不是声明式配置，而是命令式操作。
- 真正健壮的做法是让包作者在 Git 仓库中把
bin/文件设为可执行：git update-index --chmod=+x bin/phpunit - 如果你是包维护者，在
composer.json中正确声明"bin": ["bin/phpunit"]，并确保 Git 记录了权限位 - 项目级补救：只在 CI 的 Linux 步骤中单独加一行
chmod +x vendor/bin/*，不要塞进post-install-cmd
PHP 版本不一致导致脚本运行时失败
有些包的脚本（尤其是 post-autoload-dump 或自定义命令）会调用 PHP 8.0+ 才有的语法（比如 match 表达式、联合类型），但你的本地 PHP 是 7.4。这时 composer install 可能成功，因为 platform 配置骗过了依赖解析；可一执行脚本，就立刻报 ParseError: syntax error, unexpected token "match"。
关键点在于：config.platform 只控制“装什么”，不控制“怎么跑”。它不会让旧版 PHP 突然支持新语法。
- 验证方式：在脚本执行前加
php -v输出，确认实际运行的是哪个 PHP 版本 - CI 中务必用显式路径调用，例如
/usr/bin/php8.1 composer install，而不是依赖$PATH里的默认版本 - 避免在
scripts中写php some-script.php，改用/usr/bin/php8.1 some-script.php显式绑定
composer install 主流程，错误被吞掉或只出现在详细日志里。等你发现命令跑不了、类加载失败、测试挂了，才回头翻 -vvv 日志，已经浪费大量排查时间。
