应显式指定目标PHP版本路径执行composer install，如Linux/macOS用/usr/bin/php8.2 composer install，Windows用"C:\php\php-8.2.12\php.exe" composer install，并确保which php与composer diagnose输出的PHP二进制路径一致。
composer install 报 “requires php ^8.2 but your PHP version (7.4.33) does not satisfy that requirement”
这不是 Composer 故意卡你，而是它在用 php -v 输出的真实版本去校验 composer.json 里写的 "php": "^8.2"。不匹配就直接退出，连依赖树都不算。
常见误操作包括：
- 看到报错就加
--ignore-platform-reqs，结果vendor里装进一堆 PHP 8.2 语法（比如match表达式），一运行就ParseError: unexpected token "match" - 改了
composer.json的require却没跑composer update --lock，导致composer.lock还记着旧包版本 - 以为
php -v显示 8.2 就万事大吉，但composer install实际调用的是另一个 PHP（比如宝塔 wrapper、alias php=...或 PATH 顺序错乱）
正确做法是让 Composer 明确按目标版本解析依赖：
- Linux/macOS：
/usr/bin/php8.2 composer install - Windows：
"C:\php\php-8.2.12\php.exe" composer install - 确认生效路径：
which php和composer diagnose | grep "PHP binary"输出必须一致
报 “ext-gd is missing” 或 “ext-mbstring required” 怎么办
错误里明确写了缺哪个扩展，比如 ext-gd、ext-mbstring、ext-xml，先别急着忽略——先确认你是否真需要它。
有些扩展只是生产环境或特定功能才依赖（比如 ext-redis 仅用于缓存，开发时不用可跳过），而 ext-json、ext-curl、ext-openssl 是 Composer 自身运行必需的，不能跳过。
验证真实环境：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 查当前启用的扩展：
php -m | grep gd（把gd换成报错里的名字） - 确认
php.ini路径：php --ini，然后检查对应php.ini是否启用了extension=gd等行 - Windows 用户注意：CLI 和 Apache 可能用不同
php.ini，php -m查的是 CLI 模式下的扩展
若只是开发调试且确定不触碰相关功能，可精准跳过：
- 只跳过 GD：
composer install --ignore-platform-req=ext-gd - 同时跳过多个：
composer install --ignore-platform-req=php --ignore-platform-req=ext-gd - 拼写必须和
php -m输出完全一致，比如是ext-curl，不是curl或php-curl
报 “Your lock file does not contain a compatible set of packages”
这跟 PHP 版本或扩展无关，是 composer.json 的 require 规则变了，但旧 composer.lock 还锁着老版本，Composer 拒绝“睁眼装”。--ignore-platform-reqs 在这里完全无效。
干净做法：
- 删掉
composer.lock，再执行composer install—— 它会按新composer.json全量重解依赖树 - 想保留当前已安装的包版本？用
composer update --lock，它只更新lock文件结构，不改任何包版本 - CI/CD 中必须确保
composer.lock已提交且未被.gitignore，否则每次构建都可能装出不同结果
为什么 vendor/bin/phpunit 执行时报错，跟 --ignore-platform-reqs 有关
有些命令行工具（如 phpunit、larastan）自身在 require 里写了 "php": "^8.1"。即使你靠 --ignore-platform-reqs 装上了，它们启动时仍会自己校验 PHP 版本并拒绝运行。
这不是 Composer 安装阶段的问题，而是这些工具自身的运行时检查。所以：
-
--ignore-platform-reqs只解决“装得上”，不解决“跑得动” - 如果本地 PHP 是 7.4，却硬装了要求 PHP 8.2 的
phpunit，运行时就会直接报错，和 Composer 无关 - 真正要做的，是让
phpunit命令本身也用对版本的 PHP 执行，例如：/usr/bin/php8.2 vendor/bin/phpunit
最易被忽略的一点：你可能解决了 Composer 安装问题，但没意识到后续命令行工具会二次校验——它们不读 composer.json，只看自己 require 和当前 PHP 解释器版本。
