composer.lock 文件不受镜像源变更影响，但切换镜像后必须清空 vendor 并重装，否则因 autoload 路径、符号链接、编译产物、元数据解析等不一致导致运行时错误。
composer.lock 文件不受镜像源变更影响，但镜像切换后必须清空 vendor 重装——否则依赖加载会出错、类找不到、扩展编译产物失效。
换镜像不会改 composer.lock 内容，但会破坏 vendor/ 的一致性
镜像源（如阿里云、华为云）只是 packagist.org 的只读缓存代理，composer.lock 里记录的包版本、哈希、dist URL 都来自原始元数据。换镜像前后，composer.lock 文件本身完全不变。
但问题出在 vendor/ 目录：它不是纯下载结果，而是根据 lock + 当前平台 + 当前镜像行为动态生成的混合产物。常见破坏点包括：
-
vendor/autoload.php里硬编码了 dist 包解压路径和 classmap 映射，这些路径可能因镜像 CDN 节点不同而变化 - 本地开发包（
"type": "path"）的符号链接指向原机器绝对路径，复制到新环境直接 dangling - 某些扩展（如
ext-protobuf）会在vendor/子目录写入平台相关编译文件，跨镜像/跨机器复制会崩溃 -
autoload_static.php和composer/installed.php依赖当前lock解析顺序和镜像返回的包元数据字段完整性，混用易静默错装
composer install 报错 “Package has a PHP requirement incompatible…” 的真实原因
这不是镜像的问题，而是 composer.lock 中的 platform 字段没被完整保留或被编辑器破坏。常见现象：
- Windows 编辑器自动把
composer.lock换行符转成 CRLF，Git 默认启用core.autocrlf true时会污染哈希校验 →composer install拒绝执行 - VS Code 或 PHPStorm 自动删掉 JSON 末尾逗号（trailing comma），导致
platform字段解析不全 → PHP 版本约束丢失，composer install退化为update行为 - 有人手动 patch
composer.lock改某个包的 version 字段，但漏掉对应哈希 → 安装时校验失败，回退到求解模式，结果装错版本
验证方式：composer validate --strict 必须通过；检查 Git 提交历史中 composer.lock 是否有非 composer install/update 产生的修改。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
CI/CD 中 vendor 目录不能“复用”的硬性条件
Docker 构建或 CI 脚本里，只要镜像源变了（哪怕只是从阿里云切到腾讯云），就必须执行：
rm -rf vendor composer.lockcomposer install --no-dev --optimize-autoloader
不能跳过这一步的理由：
-
composer config --list | grep repositories输出必须匹配预期镜像 URL，否则 abort —— 防止因全局配置残留或项目级repositories覆盖导致行为不一致 - 多阶段构建中，builder 阶段的
vendor/是基于该阶段镜像生成的，final 阶段若 COPY 过去却不验证关键文件（如vendor/autoload.php是否可 require），运行时直接 fatal error - 私有包的 dist URL 在 lock 文件里是相对路径，实际下载地址由镜像拼接，不同镜像的 base URL 不同，旧
vendor/里缓存的 URL 已失效
团队协作中最容易被忽略的原子性前提
composer.lock 是带完整哈希校验的二进制快照，不是文本配置文件。它的正确性不取决于“看起来一样”，而取决于：
- 是否由同一版本 Composer（推荐
2.9.6）生成 - 是否提交了全部字段（包括
platform、packages、packages-dev、content-hash） - 是否未被任何工具（IDE、Git hook、CI 脚本）自动格式化或 trim whitespace
一旦有人在本地运行 composer update --lock 后不提交，就等于把个人环境的偶然结果当成了项目契约——这个错误在 CI 日志里表现为 Lock file operations: 123 installs, 45 updates，而你只改了一个包。
