离线环境用 composer install 能跑通，前提是 vendor 目录已完整存在且 php 环境一致；只传 composer.lock 会报 “package not found”，因 composer 默认仍访问 packagist.org 校验元数据，须设 composer_disable_network=1 并确保 lock 中无 dev 分支、dist.url 非 https 开头，再执行 composer install --no-plugins --no-scripts --no-autoloader 后 dump-autoload。
离线环境用 composer install 能跑通，前提是 vendor 目录已完整存在且 PHP 环境一致；局域网同步依赖包最稳的方式是直接拷贝 vendor/ + composer.lock，而不是靠缓存或镜像——后者配置成本高、易出 silent failure。
为什么只传 composer.lock 会报 “Package not found”
这不是文件缺失，而是 composer install 在解析 lock 文件时默认仍要访问 repo.packagist.org 校验元数据。哪怕 vendor 已存在，只要没显式禁用网络，它就会发起 HTTP 请求并失败。
-
COMPOSER_DISABLE_NETWORK=1必须设，且要在运行前生效（Linux/macOS：export COMPOSER_DISABLE_NETWORK=1；Windows CMD：set COMPOSER_DISABLE_NETWORK=1） -
composer.lock中每个包的dist.url字段不能是https://开头——否则即使禁用网络也会退出 - 若锁文件里含
dev-main或dev-master，离线时无法解析分支信息；联网机需先执行composer update --lock强制转为语义化版本（如2.10.0） - 检查
composer.json是否含"minimum-stability": "dev"，删掉或改为"stable"
局域网内怎么同步新包或更新依赖
离线机器上不能运行 composer update，它必须联网。所谓“同步”，本质是换机器操作：所有变更都在开发机完成，再把结果推过去。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在联网开发机上执行
composer require vendor/package或composer update，生成新composer.lock - 确保开发机 PHP 版本、扩展（如
ext-zip、ext-openssl）、架构（x86_64/aarch64）与目标机完全一致 - 打包时带上完整
vendor/目录（不是只传composer.lock），并删掉vendor/composer/installed.json（含绝对路径，易导致 autoload 失败） - 目标机解压后，运行：
COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader，最后补composer dump-autoload -o
用 path 仓库装本地包要注意什么
这是局域网调试私有组件最轻量的方式，但路径和元数据稍错一点就报 Could not find package，不是网络问题，是校验失败。
- 本地包目录下必须有合法
composer.json，且"name"字段（如"acme/utils"）要和composer require时写的完全一致（大小写、vendor 段都不能错） - 项目根目录的
composer.json中添加repositories，"type": "path"的"url"必须是绝对路径（Windows 示例：C:/projects/my-pkg；macOS/Linux 示例：/Users/xxx/pkg） -
require时版本号必须匹配本地包的"version"或分支名（如"acme/utils": "dev-main"），不支持*或^1.0 - 某些 Composer 版本要求本地包目录已初始化 Git：
git init && git add . && git commit -m "init"
缓存目录 ~/.composer/cache/files 能不能直接复用
能，但非常脆弱：路径不对、权限不足、PHP 版本不一致都会导致 Composer 静默 fallback 到远程源，而不是报错提醒你。
- 缓存必须完整复制到离线机的相同路径（如 Linux 下是
/root/.composer/cache/files或/home/user/.composer/cache/files） - 确保离线机用户对缓存目录有读权限；Windows 下注意路径分隔符和盘符是否匹配
- 缓存只解决
dist包下载，不解决元数据校验——仍需COMPOSER_DISABLE_NETWORK=1+ 完整composer.lock - 比起折腾缓存，直接拷贝
vendor/更快、更确定；尤其当项目含二进制扩展（如ext-gd）时，缓存 zip 解压后可能因系统差异无法加载
最常被忽略的是 vendor/composer/installed.json 和 autoload.php 的路径硬编码问题——它们在打包迁移后容易失效，必须重跑 dump-autoload，不能跳过。
