离线时composer install报“Could not find package”是因为默认仍尝试连接Packagist获取元数据，不会自动fallback到本地path仓库；必须确保repositories中path条目排首位、禁用packagist全局配置、使用--no-plugins，并验证composer config repositories输出仅含正确相对路径的path源。
离线环境里 Composer 能用本地 path 仓库，但必须跳过所有网络校验、禁用插件干扰、且不能依赖 Packagist 回退——它要么从你指定的本地路径读取，要么直接失败。
为什么 composer install 在离线时仍报 “Could not find package”
不是缓存没清或镜像没切，而是 Composer 默认仍会尝试连接 Packagist 获取元数据（比如包列表、版本约束解析），哪怕你已配了 repositories。离线时这个请求超时后，它不会自动 fallback 到本地 path，而是直接中断。
- 确保项目级
composer.json的repositories数组中，type: "path"条目排在第一位（Packagist 必须放在后面或干脆删掉） - 运行
composer install --no-plugins：插件（尤其是composer/installers或自定义仓库插件）可能偷偷触发网络请求 - 检查是否启用了
packagist.org的全局配置：composer config -g repositories.packagist，若存在，用composer config -g --unset repositories.packagist删除 - 确认
composer.lock文件存在且完整——离线环境下composer install完全依赖它，没有 lock 文件就无法确定包来源和版本
composer update 离线执行失败的真正原因
离线时 composer update 默认会联网检查远程分支更新、验证版本稳定性（如 dev-main 是否有新 commit）、甚至拉取 packages.json 元数据。这些行为在无网时必然卡住或报错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 强制离线更新：加
--no-cache --no-interaction --ignore-platform-reqs，最关键的是--prefer-source（确保走本地 Git 目录而非 dist 包） - 但注意：
composer update vendor/name仍会尝试读取该本地包目录下的 Git 状态——如果没初始化 Git 或没 commit，会静默跳过；务必提前在本地包目录执行git init && git add . && git commit -m "init" - 若本地包没 Git，改用
"version": "dev-main"+"dist": {"type": "path", "url": "../my-pkg"}形式绕过 Git 检查（需 Composer 2.2+）
如何验证本地 path 仓库是否真被离线识别
别信 composer install 输出的 “Installing…” 行，它可能只是从 lock 文件复制旧结果。要确认 Composer 当前实际加载的源，得看它“看到”了什么。
- 运行
composer config repositories（不加-g），输出应只含你写的path条目，且url是相对路径（如"../my-utils"），不能是file://或绝对路径 - 执行
composer show -a vendor/name，若显示source: path ../my-utils且dist: none，说明走对了本地路径；若显示source: git或报错找不到包，说明配置未生效 - 检查
vendor/vendor/name是否为符号链接：ls -la vendor/vendor/name应含-> ../my-utils；Windows 下用dir vendor\vendor\name看是否为“快捷方式”类型
离线场景下最易被忽略的一点：Composer 不会自动检测本地包目录内容变更。你改了 composer.json 里的 autoload 或新增了文件，必须手动运行 composer dump-autoload，否则自动加载器还是旧的——这和网络无关，纯属本地缓存逻辑。
