Composer autoload失败主因是composer.json中autoload配置错误，需确保PSR-4命名空间、目录路径、文件名三者严格一致，且必须执行composer dump-autoload -v验证映射是否生成。
composer.json 里 autoload 配置写错，类根本找不到
PSR-4 映射路径不匹配是最常见的自动加载失败原因。不是“写了就生效”，而是必须严格满足命名空间、目录结构、文件名三者一致。
-
src/目录下有MyPackage/Helper.php，但composer.json里写的是"MyPackage\": "src/MyPackage/"→ 错：应改为"MyPackage\": "src/" - 类文件用了大驼峰命名（
UserValidator.php），但类名是userValidator→ 错：PHP 类名必须首字母大写，且文件名需完全匹配 - 用了
autoload-dev但没运行composer dump-autoload --dev→ 测试类不会被加载，phpunit报Class not found
验证方式：运行 composer dump-autoload -v，看输出里是否包含你期望的映射；再用 composer show --tree 确认包已注册。
CI 流水线里 require-dev 包被漏装，测试直接挂掉
CI 环境默认执行 composer install --no-dev，但很多测试工具（如 phpunit、php-cs-fixer）依赖 require-dev。漏装会导致脚本找不到命令或类。
- GitHub Actions 中未显式加
--no-dev，但用了composer install→ 实际仍会装 dev 包，但不可靠，应明确控制 -
composer.json里把roave/security-advisories放在require→ 它不提供任何可调用代码，只做安装时冲突拦截，必须放require-dev - 本地能跑通测试，CI 报
Class 'PhpCsFixerFinder' not found→ 检查 CI 步骤是否漏了composer install --dev或等效命令
建议：CI 中统一用 composer install --no-interaction --prefer-dist，再根据阶段补装 dev 包 —— 测试阶段加 --with-all-dependencies，而非盲目删 --no-dev。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
私有包发布后，下游项目 composer update 找不到新版本
不是 push 到 Git 就完事。Composer 不拉 Git 分支，它只认 tag + Satis（或 Packagist 兼容源）暴露的元数据。
- 打了
v1.2.0tag，但 Satis 仓库没刷新 → 运行php bin/satis build satis.json web/并确保 Web 服务能访问web/packages.json - Satis 配置里
"repositories"指向内部 Git 地址用了https://，但 CI 机器没配置 Git 凭据 → 改用 SSH URL（git@xxx:org/pkg.git）并配好 deploy key - 下游项目
composer.json里没加私有源："repositories": [{"type": "composer", "url": "https://satis.internal/"}]→ 必须显式声明，否则 Composer 只查 packagist.org
验证方法：在下游项目执行 composer config --list | grep repos，确认私有源已注册；再用 composer show vendor/package 查看可用版本列表。
PHP-CS-Fixer 和 PHPCS 卡点没生效，CI 依然合入格式错误代码
静态检查工具只是命令，不接入 Git 钩子或 CI 就等于没存在。常见失效场景是“本地能跑，CI 不执行”或“执行了但没 fail”。
- 预提交钩子用了
php-cs-fixer fix但没加--dry-run --diff→ 修复动作静默完成，无法阻断 commit - CI 脚本里写
./vendor/bin/phpcs但没接|| exit 1→ 即使报错也继续往下走 - PHPCS 规则文件
.phpcs.xml里用了<rule ref="PSR12"/>，但项目根目录没放phpcs.xml.dist→ CI 加载不到规则，变成空跑
关键细节：CI 中 PHPCS 必须带 --report=checkstyle --report-file=phpcs-report.xml 输出 XML，才能被主流平台（如 GitHub Code Scanning）解析；而 PHP-CS-Fixer 在 CI 中应只做检查，不做修复 —— 修复留给开发者本地完成。
