composer install必须有composer.lock才能离线运行，因其设计仅消费锁文件，严格按其中记录的精确版本、哈希值、url及依赖树还原环境；缺失则报错或退化为需联网的update。
composer install 为什么必须有 composer.lock 才能离线运行
因为 composer install 的设计就是“只消费锁文件”，它不解析 composer.json 中的版本范围（如 "^2.0"），而是严格按 composer.lock 里记录的精确版本、dist.shasum、dist.url 和完整依赖树来还原环境。没有 composer.lock，命令会直接报错或退化为 composer update——后者必然联网。
常见错误现象：Command "install" is not defined（Composer 2.5+）、No composer.lock file present，或 CI 卡在 Resolving dependencies...——本质都是在隐式重算依赖，触发远程元数据请求。
-
composer.lock不是可选产物，是离线部署的强制前提 - 它包含
content-hash，校验整个依赖图完整性；手动修改字段、调整缩进、Git 合并时“保留一方”都会破坏该哈希，导致后续安装失败 - 锁文件中
platform字段（如"php": "8.2.15"）是当时解析所用环境快照，不是运行时校验依据，但影响子依赖是否被纳入
离线前必须验证 lock 文件是否完整且可复现
不能只拷一个 composer.lock 就完事。它只是“清单”，没对应“货物”（vendor 或缓存包）就等于空头支票。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在联网机执行
composer install --no-dev --prefer-dist --no-scripts --no-plugins --optimize-autoloader，确保所有 dist 包下载进缓存，并生成可用的vendor/ - 检查
composer.lock是否含"dist": {"type": "zip", "url": "...", "shasum": "..."}字段——若某包是"source"类型（如"dev-main"或 Git URL），离线时无法校验，install必然失败 - 运行
composer install --dry-run（Composer 2.5+）预览行为：不改任何文件，只校验 lock 是否能走通本地路径或缓存
离线机上 lock 文件配合 vendor 目录的最小安全启动方式
最稳方案是直接复制 vendor/ + composer.lock，但必须绕过默认的联网校验环节。
- 先清掉可能残留的全局配置干扰：
composer config --global repo.packagist false - 执行：
COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader - 立刻补一记：
composer dump-autoload -o，否则Class not found概率极高 - 不要加
--ignore-platform-reqs：它会掩盖mbstring、openssl等扩展缺失问题，让错误延后到运行时才暴露
lock 文件被改写或平台不一致时的硬性约束
哪怕只改了 composer.json 里一行 PHP 版本约束，只要没跑 composer update --lock，离线机上的 install 就可能卡住或失败。
- 源机与目标机的 PHP 小版本必须一致（如 8.2.12 vs 8.2.13），否则某些包内语法或内部 API 微变会导致 autoload 失败
- 如果
composer.lock中platform.php是"7.4.33"，而目标机是 PHP 8.2，install会直接退出，提示Your requirements could not be resolved - 新增包不能靠
composer require离线添加——它必须联网查包名和版本。唯一合法方式是配path仓库，且url必须是相对路径（Windows 需带盘符，如C:/packages/my-pkg）
composer install 就会在你最不想它动的时候，悄悄尝试连上 repo.packagist.org。
