离线安装中文依赖包的关键是避免缓存路径含中文，因未转义中文会致file:// URI解析失败而报错；需预下载时用英文缓存路径、离线机显式设COMPOSER_CACHE_DIR、必加COMPOSER_DISABLE_NETWORK=1及--no-autoloader等参数。
离线模式下用预下载的中文依赖包安装，关键不是“中文”，而是缓存路径含中文时会触发 file_get_contents() 或 cURL 的 URI 解析失败——Composer 会把未转义的中文字符当非法 URL 处理，直接报 failed to open stream: No such file or directory。
为什么“中文依赖包”本身不构成问题
Composer 对包名、版本、描述等字段的编码无特殊限制，composer.json 里写 "name": "vendor/中文包" 完全合法。真正出问题的是本地缓存路径含中文字符（如 /home/张三/.composer/cache），导致 Composer 内部拼接 file:// URL 时生成无效路径。
- Composer 在读取缓存 zip 包时，会构造类似
file:///home/张三/.composer/cache/files/vendor/name/sha256.zip的 URI - Linux/macOS 下，
file://协议要求路径必须是 URI-safe 的（即 ASCII 字符 + % 编码），中文未转义即被拒绝 - Windows 上表现稍异，但 PowerShell 的
$env:USERPROFILE返回含中文路径时，同样可能触发 autoload 映射异常
预下载阶段必须强制使用英文缓存路径
在联网机器上执行预下载前，先重置全局缓存目录为纯英文路径，否则缓存文件即使拷过去也无法被识别：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config --global cache-dir /tmp/composer-cache-en（Linux/macOS）或composer config --global cache-dir C:\composer-cache（Windows） - 再执行
composer install --no-dev --prefer-dist --optimize-autoloader，确保所有包以 dist 方式进缓存 - 验证缓存有效性：用
find /tmp/composer-cache-en/files -name "*.zip" | head -n 3确认有实际文件；用composer show monolog/monolog --locked查看其dist.shasum，再手动ls /tmp/composer-cache-en/files/monolog/monolog/*${shasum:0:8}*.zip确认存在
离线机上不能复用默认 $HOME 路径
即使你把缓存目录整个拷到离线机，若没显式设置 COMPOSER_CACHE_DIR，Composer 仍会去读默认路径（如 $HOME/.composer/cache），而该路径在离线机上为空或含中文，导致 fallback 失败：
- Linux/macOS：执行前必须
export COMPOSER_CACHE_DIR=/path/to/your/cachedir（路径须与预下载机一致且为英文） - Windows CMD：
set COMPOSER_CACHE_DIR=C:\composer-cache；PowerShell：$env:COMPOSER_CACHE_DIR="C:\composer-cache" - 切勿依赖
composer config --global cache-dir设置——它只影响 future 操作，对当前install命令无作用，环境变量优先级更高
离线安装命令必须带 COMPOSER_DISABLE_NETWORK=1
哪怕缓存齐全、路径正确，不设这个环境变量，Composer 仍会在解析 lock 文件阶段主动请求 https://repo.packagist.org/packages.json，卡在 Loading composer repositories 并报错：
- 正确命令：
COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader --prefer-dist -
--no-autoloader是必须项：避免 autoload 重建时因路径差异（如 vendor 目录位置变化）触发类加载器异常 - 执行完立刻补
composer dump-autoload -o，否则运行时大概率Class not found - 验证是否真离线：临时往
/etc/hosts加127.0.0.1 repo.packagist.org，再跑上述命令——看到Connection refused才算生效
最容易被忽略的是缓存路径的跨系统一致性：Windows 上 C:\composer-cache 和 Linux 上 /opt/composer-cache 必须结构完全相同，且所有 zip 文件名（含哈希值）一字不差；一旦 Composer 版本主号不一致（如预下载用 2.9.x，离线机是 2.8.x），缓存目录下的子目录命名规则可能不同，files/ 下的文件就根本找不到。
