composer install只认composer.lock是因为其设计目标是“确定性复现”，它跳过所有版本解析，直接按lock中记录的精确包名、版本号、dist URL和SHA256哈希值拉取解压，完全忽略composer.json中的^或~等约束符号。
composer install 为什么只认 composer.lock，不看 composer.json 的版本约束？
因为 composer install 的设计目标就是「确定性复现」——它跳过所有版本解析逻辑，直接按 composer.lock 中记录的精确包名、版本号、dist URL 和 SHA256 哈希值拉取和解压。哪怕 composer.json 里写着 "monolog/monolog": "^3.0"，只要 lock 文件里锁的是 3.5.1，install 就只会装 3.5.1，绝不会去 Packagist 查 3.6.0 是否存在。
常见错误现象：composer.json 已升级 Laravel 到 ^10.0，但执行 composer install 后 vendor/laravel/framework 仍是 9.52.16 ——这不是 bug，是 lock 文件没更新，install 就不会动。
- 只有删掉
composer.lock或运行composer update，才会触发重新解析composer.json中的约束 - CI/CD 环境中若误传了旧 lock 文件，会导致线上部署的依赖与本地开发完全不一致
- 多人协作时，
composer.lock必须提交进 Git；漏提交 = 每个人 install 出来的 vendor 都可能不同
多分支包（如 dev-main、dev-feature/x）在 install 时如何定位具体 commit？
composer install 不从分支名拉代码，而是根据 composer.lock 里 packages 或 packages-dev 下每个包的 source.reference 字段，去 Git 仓库精确检出对应 commit。这个 reference 是上一次 composer update 或 composer install --no-cache 时解析出来的。
常见错误现象：composer install 报 Could not find package vendor/name at version dev-main，或提示 dist.sha256 does not match ——本质是 lock 文件里存的 reference 在当前远程仓库已不可达（比如分支被 force-push 覆盖、或被删除）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 不要手动编辑
composer.lock修改source.reference：JSON 结构易破坏，且packages与packages-dev中同名包可能 reference 不一致 - 正确清理方式：删
composer.lock+composer install --no-cache，让 Composer 重新走一遍分支解析流程 - 若项目必须锁定到某分支特定 commit（如
"dev-feature/auth as 1.0.0"），确保该分支在origin上存在且可git ls-remote查到
PHP 版本不匹配时，install 失败的根本原因和绕过风险
composer install 在读取 composer.lock 前，会先校验当前 PHP CLI 版本是否满足 composer.json 中 "php": "^8.3" 这类 platform 约束。它不关心 Web 服务器用的 PHP-FPM 版本，只认 php -v 输出的那个。
常见错误现象：This package requires php ^8.3 but your PHP version (8.1.25) does not satisfy that requirement，而 phpinfo() 显示 Nginx 正在跑 8.3-fpm ——这说明 CLI 和 FPM 版本分离，但 Composer 只能看见 CLI。
- 临时解决：显式调用目标 PHP 二进制，例如
/usr/bin/php8.3 composer install（Linux/macOS）或"C:\php\php83\php.exe" composer install（Windows） - 慎用
--ignore-platform-reqs：它跳过 PHP 版本检查，但 vendor 中可能混入match、readonly等高版本语法，运行时报ParseError -
config.platform.php是编译期伪装，不影响 runtime；设成"8.3.0"后仍需确保实际运行环境有对应扩展和语法支持
vendor/autoload.php 为何不能跨 PHP 版本复用？
因为 vendor/autoload.php 是 Composer 根据当前 PHP 版本生成的静态映射文件，内部包含大量版本敏感逻辑：反射获取类常量的顺序、class_exists() 行为差异、扩展加载路径（如 ext-gmp 是否可用）、甚至 PHP 8.2+ 新增的 enum 类型检测逻辑。这些都会影响 autoload_static.php 中的数组结构。
常见错误现象：在 PHP 8.1 下 composer install 生成的 vendor/，挪到 PHP 8.3 环境运行时报 Class 'App\Models\User' not found，即使文件物理存在 —— autoload 文件里的类映射表已失效。
- 切换 PHP 版本后，必须删除整个
vendor/目录和composer.lock，再重新composer install - 不要在 CI 中缓存
vendor/跨版本复用；应按 PHP 版本分 cache key，例如php-8.2-vendor和php-8.3-vendor - 宝塔、XAMPP 等集成环境用户尤其注意：面板里切换 PHP-FPM 版本 ≠ 终端
php命令自动同步
