ci/cd 中必须使用 composer validate --strict --no-check-publish，这是防止 packagist 拒绝提交或构建中断的硬性门槛：--strict 将字段拼写错误、非 spdx 许可证等警告升级为错误，--no-check-publish 跳过网络依赖检查以避免 ci 因抖动失败。
CI/CD 里必须用 composer validate --strict --no-check-publish
这不是“建议”，是防止 Packagist 拒绝提交或 CI 构建中途失败的硬性门槛。默认 composer validate 只校验 JSON 合法性和基本字段，比如 name、type 是否存在；但拼错成 "autoloader": {}（正确应为 "autoload": {}）它不会报错——直到你 push 到 Packagist 才被拦截。
--strict 的作用不是“更严一点”，而是把原本只 warning 的问题（如 license 不在 SPDX 列表、描述超长、字段名拼写错误）直接转成 exit code 1；--no-check-publish 则跳过远程包名查重、source 可读性等网络依赖检查，避免 CI 因临时网络抖动失败。
- 本地开发可先跑
composer validate快速过基础结构 - CI 脚本第一行就该是
composer validate --strict --no-check-publish - 若失败，错误信息里带
schema字样，大概率是字段名写错或版本约束语法不兼容（如 Composer 1.x 不认^2.0 || ^3.0）
composer.json 格式合法 ≠ 自动加载能用
composer validate 从不加载类、不扫描文件、不验证 PSR-4 映射是否真实存在。所以常见现象是：本地 composer install 成功，CI 里 require 报 Class not found。
关键检查点在 autoload 配置本身：
-
psr-4映射末尾必须带反斜杠："My\Package\": "src/"，写成"My\Package": "src/"会导致子命名空间（如MyPackageUtils）映射失败 -
files类型 autoload 引入的 PHP 文件，validate完全不检查语法——得靠php -l单独扫 - 测试前删掉
vendor/和composer.lock，再跑composer install && composer dump-autoload -o，然后手动php -r "require 'vendor/autoload.php'; new MyPackageSomeClass();"
为什么不能只信 composer install 的成功？
composer install 成功只说明依赖能装上、lock 文件能解析，不代表你的包元数据合规、不触发 Packagist 静默拦截。比如 name 字段写成 my/package（含大写字母）或 my_package（下划线），validate 会直接报错；但 install 照常运行，直到你点 Submit 页面卡住、返回 400 才知道问题在哪。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
真正要拦截的，是这类“运行时无感、发布时致命”的配置缺陷：
-
name必须是全小写 + 字母数字 + 短横线，且符合vendor/name格式 -
license值必须来自 SPDX 官方列表（如"MIT"、"Apache-2.0"），写"Apache 2.0"或"see LICENSE"会被--strict拒绝 -
autoload和autoload-dev的路径指向目录必须真实存在，否则dump-autoload会出错——但validate不管这个
CI 流程中 validate 的位置和联动逻辑
它必须是整个流程最前面的守门人，早于 composer install、早于 composer audit、早于任何代码执行。因为一旦 composer.json 有 schema 错误，后续所有命令都可能行为异常或掩盖真问题。
典型 CI 步骤链：
composer validate --strict --no-check-publishcomposer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritativecomposer audit --no-dev --format=json | jq -e 'any(.advisories[]; .severity == "critical" or .severity == "high")' > /dev/null || exit 1- 运行单元测试、静态分析等
漏掉 validate 或把它放在后面，等于让 CI 主动绕过最廉价、最快速的元数据防线——而修复一个拼错的字段，远比 debug 一个因 autoload 失效导致的 class-not-found 更省时间。
