无网络环境无法配置Composer镜像源，因Composer启动时强制校验openssl、curl等扩展，失败则直接退出；离线唯一可行方案是预下载依赖并复用vendor目录和composer.lock文件。
无网络环境根本不能配镜像源
Composer 镜像配置本质是修改请求地址，让它指向国内 HTTPS 服务器；没网络时连 composer config 命令都执行不了——因为 Composer 启动时会强制校验 php.ini 中的 openssl、curl 等扩展是否可用，而这些扩展加载失败或缺失时，命令直接报错退出，根本走不到写配置那步。
更关键的是：composer config -g repo.packagist 这类命令本身不依赖外网，但它的生效前提是 Composer 能正常初始化。无网络环境下常见报错包括：
-
PHP Warning: Module 'openssl' already loaded in Unknown on line 0（模块重复加载，常因 php.ini 多次 include） -
Could not open input file: composer.phar（路径不对或权限不足） -
Command "config" is not defined.（Composer 版本太低或损坏）
所以第一步不是想“怎么换源”，而是确认本地 PHP 环境是否真正就绪：
- 运行
php -v，必须输出版本号且无 fatal error - 运行
php -m | grep -E "openssl|curl|zlib"，三个扩展必须全部列出 - 运行
which composer或where composer（Windows），确认二进制存在且可执行
离线场景下唯一可行的“镜像”方案：预下载 + vendor 目录复用
真正的离线开发，靠的不是改配置，而是提前把依赖全拉下来、打好包、拷过去。镜像源在这里只起一个作用：加速预下载阶段。
操作流程如下：
- 在有网机器上，进入目标项目根目录，先执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（项目级，不加-g） - 再运行
composer install --no-dev --prefer-dist -vvv，观察日志里是否出现mirrors.aliyun.com，确认走的是镜像 - 成功后，打包整个
vendor/目录和composer.lock文件（二者必须一起） - 把这两个东西拷到离线机器对应项目路径下，无需任何
composer命令即可直接运行项目
注意：composer.lock 是关键。它记录了每个包的 exact commit hash 和 dist URL，离线时 Composer 不再发起网络请求，而是直接解压本地 vendor/ 里的归档文件。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
如果后续要增删依赖，必须回到有网环境操作，再重新打包同步。
误以为“离线配镜像”的典型错误操作
很多人试图在断网状态下手动编辑 ~/.composer/config.json 或项目 composer.json 的 repositories 字段，以为只要写进去就生效。实际结果是：
- 手动写的
"packagist": false或"packagist.org": false会导致 Composer 直接拒绝解析所有包，报错Could not find package xxx - 写错键名如
repos.packagist（多一个s）或漏掉"type": "composer"，Composer 启动时静默忽略，仍尝试连packagist.org，然后卡死在 DNS 查询环节 - URL 写成
http://或末尾缺/，Composer 2.0+ 会直接拒绝加载该源，但不报错，只 fallback 到默认源——而离线时这个 fallback 就是彻底失败
这些错误在有网时可能表现为“慢”或“超时”，但在离线时就是立即中断，毫无回旋余地。
宝塔、Docker 或 CI 环境下的离线等效方案
严格意义上的离线不可配镜像，但有些“类离线”场景可以绕过网络依赖：
- 宝塔面板里，若 PHP CLI 禁用了
proc_open或putenv，Composer 根本启动不了——这看起来像“没网”，实则是函数被禁。先去「PHP 管理 → 禁用函数」里删掉它们 - Docker 构建时用
--network=none，但镜像层已缓存 vendor，只需在Dockerfile里 COPY 预下载好的vendor/和composer.lock，跳过composer install - GitHub Actions 中设
COMPOSER_CACHE_DIR指向缓存卷，并用actions/cache缓存~/.composer/cache，下次构建可复用已下载包，减少对外网依赖
所有这些方案的核心逻辑一致：把网络动作前置到有网阶段，离线时只做文件搬运和加载。试图在无网络条件下“配置”镜像，等于给一辆没油的车调油表——表能动，车不动。
