离线更新单个包需先确认依赖已缓存，否则无法执行；应检查 vendor/composer/archives/ 或 ~/.composer/cache/files/ 是否存在对应 zip 包，无缓存则必须联网预下载；禁用网络时可用 composer require 锁版本配合 install，或配置 path 仓库直引本地源码。
离线更新单个包：先确认依赖是否已缓存
Composer 本身不支持纯离线“更新”，它必须能解析版本约束、校验哈希、写入 composer.lock。所谓“离线更新”，本质是复用已有缓存 + 手动干预锁文件。第一步永远是检查目标包是否已在本地 vendor/composer/archives/ 或 ~/.composer/cache/files/ 中存在对应 zip —— 没缓存就真没法离线操作。
常见错误现象：Could not fetch https://repo.packagist.org/p2/vimeo/vimeo-api.json 这类报错，说明 Composer 尝试联网查元数据，此时强行加 --no-interaction --no-plugins 也无济于事。
- 运行
composer show vimeo/vimeo-api（若已安装）看当前版本和源地址 - 手动检查
~/.composer/cache/files/vimeo/vimeo-api/下是否有对应版本的.zip和.zip.sha256 - 若没有，需提前在有网环境执行
composer require vimeo/vimeo-api:^4.0 --no-install触发下载并缓存（不装进vendor）
强制重装指定包而不触发全量更新
你不是要“更新整个项目”，只是想把 vimeo/vimeo-api 换成另一个已下载好的版本。这时不能用 composer update vimeo/vimeo-api，它仍会联网查最新匹配版本；而要用 composer require 锁死版本 + 跳过仓库查询。
使用场景：你手头已有 vimeo/vimeo-api-4.1.0.zip，解压后放在临时目录，但不想上传到私仓，也不愿改 repositories 配置。
- 删掉原包：
rm -rf vendor/vimeo/vimeo-api - 用
composer require vimeo/vimeo-api:4.1.0 --no-update修改composer.json，不触发任何网络请求 - 再运行
composer install --no-scripts --no-plugins，Composer 会从本地 cache 提取 4.1.0 的 zip 并安装 - 若 cache 里没有 4.1.0，这步会失败，错误信息是：
Package vimeo/vimeo-api at version 4.1.0 has a mismatched checksum
绕过 Packagist 直接加载本地路径包
当目标包不在 Packagist、也没有预缓存，但你有它的完整源码目录（比如 Git 克隆下来的修改版），这是最可靠的离线方案。它完全不依赖远程元数据，只认本地路径和 composer.json。
睿拓智能网站系统-网上商城1.0免费版软件大小:5M运行环境：asp+access本版本是永州睿拓信息专为电子商务入门级用户开发的网上电子商城系统，拥有产品发布，新闻发布，在线下单等全部功能，并且正式商用用户可在线提供多个模板更换，可实现一般网店交易所有功能，是中小企业和个人开展个人独立电子商务商城最佳的选择，以下为详细功能介绍：1.最新产品-提供最新产品发布管理修改，和最新产品订单查看2.推荐产
参数差异：path 类型仓库优先级高于 packagist，且不校验签名或 hash，适合调试和定制化部署。
- 在
composer.json的repositories数组顶部加一段：
{
"type": "path",
"url": "./packages/vimeo-api"
}
-
./packages/vimeo-api必须包含有效的composer.json，且其中version字段要与require中声明的一致 - 然后运行
composer require vimeo/vimeo-api:dev-main --no-update（注意用分支名或带dev-前缀的版本） - 最后
composer install即可软链接或复制该目录到vendor
为什么 composer update --offline 不解决你的问题
这个 flag 只跳过网络请求，但前提是 composer.lock 里已有你要的版本记录，且本地 cache 完整。它不会帮你“升版本”——如果你的 lock 文件还锁着 3.8.0，--offline 下执行 update vimeo/vimeo-api 什么也不会变。
性能影响：启用 path 仓库后，每次 install 都会计算 symlink，比 zip 解压略慢；但兼容性极好，PHP 7.2+ 到 8.3 全支持，且不依赖 ext-zip 是否开启。
最容易被忽略的是：Composer 缓存目录权限。离线机器上若 ~/.composer/cache 属主不对，即使 zip 存在，也会静默跳过并报 checksum 错误，而不是明确提示“cache not readable”。
