应使用 --prefer-source 强制从 git 克隆源码以跳过 dist 校验，或手动删除 composer.lock 中对应包的 "shasum" 和 "reference" 字段；长期方案是配置 path repository 并在本地包中声明 version 字段。
为什么 composer install 会报 “require” 版本冲突而你又不想改 composer.json
因为某些依赖（尤其是私有包或 fork 后未发新版的包）在 composer.lock 中记录了特定提交或分支，但本地源代码已变更，Composer 默认会严格校验 dist 的 sha256 或 reference。此时不是“忽略版本检查”，而是绕过完整性校验——真正起作用的是 --ignore-platform-reqs 和 --no-scripts 之外的另一个开关：--no-plugins 并不相关，关键在 COMPOSER_NO_DEV 环境变量也无效。核心手段是强制跳过 dist 验证。
用 --ignore-platform-reqs 不能解决依赖版本不匹配问题
--ignore-platform-reqs 只跳过 PHP/扩展版本检查（如 "php": "^8.1"），对包本身的 version、dist.reference、dist.shasum 完全无影响。常见误判场景：
- 你修改了 vendor 里某个包的源码，然后运行
composer install—— 报Package <code>foo/barhas a version constraint... 错误 - 你用
pathrepo 指向本地目录，但该目录没有composer.json中声明的version字段，Composer 拒绝加载 - CI 环境中缓存了旧
composer.lock，但私有仓库已重写历史，reference失效
真正生效的两个方法：禁用 dist 校验 or 改用 source
Composer 在安装时默认优先走 dist（zip/tar 包），其完整性靠 shasum 或 reference 保证；若想跳过这些检查，只有两种可靠路径：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 加
--prefer-source：强制从 Git clone 源码，完全跳过dist下载和校验逻辑，适用于你本地有完整 repo 且已 checkout 到目标分支/commit 的情况 - 设环境变量
COMPOSER_DISABLE_NETWORK=1+ 手动删vendor+composer install --no-cache：这能防止 Composer 自动回退到 dist，但前提是composer.lock里该包的source字段存在且有效 - 更直接的做法：编辑
composer.lock，找到对应包的dist块，删掉"shasum"和"reference"字段（保留"url"和"type"），再运行composer install—— Composer 会跳过校验并尝试下载
长期方案：用 path repository + versions 伪版本控制
如果你频繁修改某个依赖，硬改 composer.lock 或每次加 --prefer-source 不可持续。正确做法是在 composer.json 中声明 path 类型仓库：
{
"repositories": [
{
"type": "path",
"url": "../my-local-package"
}
],
"require": {
"my-vendor/my-local-package": "*"
}
}
然后确保 ../my-local-package/composer.json 中包含明确的 version 字段（如 "version": "dev-main"），否则 Composer 会拒绝识别。注意："*" 不代表“任意版本”，它只匹配 composer.json 中定义的 version 值——这点极易被忽略。
