先确认是php版本过低或缺失ext-mbstring等扩展导致，而非版本号错误；运行composer install -v定位具体缺失项，用php -v和php -m检查环境，优先通过composer config platform.php声明目标版本并删除vendor与composer.lock后重装。
composer install 报 “Your requirements could not be resolved” 怎么办
这不是版本写错了，而是本地 PHP 版本或缺失扩展（如 ext-mbstring、ext-xml）不满足 composer.lock 中已锁定包的运行前提。先跑 composer install -v，看错误里明确卡在哪条 php 版本或哪个 ext-xxx。
查当前环境：php -v 和 php -m | grep mbstring（把 mbstring 换成你要查的扩展名）。别急着加 --ignore-platform-reqs；优先用 composer config platform.php 8.1.0 声明目标 PHP 版本（比如线上是 8.1，本地是 7.4），再删 vendor 和 composer.lock，重跑 composer install。
常见误操作：
- 只删
vendor却保留损坏或过期的composer.lock—— 它会继续按旧约束解析，大概率失败 - 在 CI 脚本里无条件加
--ignore-platform-reqs—— 缺失的扩展不会 magically 出现，运行时仍报Class 'Redis' not found - 用老版 Composer（如 2.2.x）配合
"platform": {"php": "8.3.0"}—— 可能生成错误的 autoload 映射，导致类加载失败
如何跳过 post-install-cmd 等脚本执行
加 --no-scripts 即可全局禁用所有 scripts（如 post-install-cmd、pre-autoload-dump），它不影响依赖下载和 vendor/autoload.php 生成，只屏蔽命令调用。
适用场景：
- CI 构建中 Node.js 未安装，避免
npm run build失败中断 - Docker 构建阶段暂不需要执行数据库迁移或资源打包
注意：
-
--no-scripts是全量开关，不能只禁用某一个脚本；想精细控制，得临时注释composer.json中对应字段 - 别和
--no-autoloader一起用 —— 后者会跳过 autoload 文件生成，运行时直接报Class not found - 如果项目依赖某个脚本产出的文件（如
public/mix-manifest.json），跳过后后续请求可能 404 或白屏
忽略平台要求但不破坏运行时兼容性
用 --ignore-platform-req=php 精准跳过 PHP 版本检查，保留对 ext-gd、ext-curl 等扩展的校验；多个项可叠加：--ignore-platform-req=php --ignore-platform-req=ext-gd。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
--ignore-platform-reqs（无等号）会跳过所有平台项，包括 lib-* 和 ext-*，风险更高；且它不解决包间依赖冲突，只绕过环境校验。
真正容易被忽略的点：
- 即使加了
--ignore-platform-req=php，PHP 8.0 运行 PHP 8.2 语法（如match表达式）仍会 fatal error —— Composer 不管运行时兼容性 - Docker 构建中 builder 阶段用了该参数装包，但 runtime 镜像没装对应扩展，部署后一调就崩
- 写了
--ignore-platform-reqs=true会被当作非法参数，命令直接退出
CI/CD 中 composer install 的安全写法
标准且唯一推荐的写法是：composer install --no-dev --optimize-autoloader。
--no-dev 跳过 require-dev 包（如 PHPUnit），避免开发工具打进生产镜像；--optimize-autoloader 生成扁平化类映射，提升自动加载性能。
绝对不要：
- 加
--ignore-platform-reqs或--force—— 它们掩盖的是真实环境缺陷 - 在部署脚本里混用
composer update—— 上线那一刻等于放弃版本控制权 - 忽略
composer.lock是否已提交 —— 它不存在时composer install会 fallback 到update行为，结果不可控
刚 clone 项目就失败？先确认三件事：composer.lock 是否存在且已提交、vendor/ 是否被 .gitignore 错误排除、composer.json 里有没有拼错的包名（比如多了一个空格）。
