不能直接拷贝 vendor 目录，因 autoload 规则、minimum-stability、插件状态及 post-autoload-dump 脚本（含绝对路径）差异会导致类找不到、插件未加载或自动加载错乱；应复用 composer 缓存或预装完整 vendor 并离线导入。
不能直接拷贝 vendor 目录，必须复用 Composer 缓存或预装完整 vendor。 直接挪用其他项目的 vendor 会导致类找不到、插件不加载、自动加载错乱，甚至因 post-autoload-dump 脚本写入绝对路径而彻底失效。
为什么不能直接复制 vendor 目录
不同项目 composer.json 的 autoload 规则、minimum-stability、启用的插件都可能不同；某些包（如 laravel/framework）的 post-autoload-dump 脚本会生成含绝对路径的文件，一复制就挂；autoload_files.php 或 autoload_static.php 里也可能硬编码了源机器路径。
- 常见错误现象：
Fatal error: Class 'Illuminate\Support\Facades\App' not found - 更隐蔽的问题：插件（如
phpstan/extension-installer）根本没触发注册逻辑 - 即使能跑，
composer dump-autoload在离线机上大概率失败，因为缺少依赖或路径校验不通过
正确复用 composer 缓存（推荐优先尝试）
Composer 默认把所有 .zip/.tar.gz 包存在本地缓存目录，只要目标服务器架构一致、PHP 版本兼容、且缓存未被清空，就能跳过下载直接解压安装。
- 联网机器上先执行
composer install --no-dev --prefer-dist，确保缓存已填充 - 打包整个缓存目录：
~/.composer/cache/（Linux/macOS）或%APPDATA%\Composer\Cache\（Windows） - 传到离线服务器对应位置，并确认
COMPOSER_CACHE_DIR环境变量指向它，或修改~/.composer/config.json中的cache-dir - 在项目根目录运行：
composer install --prefer-dist --no-scripts --no-plugins --no-dev
注意：--no-scripts 和 --no-plugins 是关键——避免因缺失扩展或环境变量导致脚本中断。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
没有缓存时：必须预装完整 vendor 并离线导入
这是最稳妥、也最常被采用的方式，尤其适用于 ThinkPHP、Laravel 等框架部署。
- 在与目标服务器 PHP 版本、扩展完全一致的联网机器上，进入项目根目录执行：
composer install --no-dev --prefer-dist --optimize-autoloader - 压缩
vendor/目录为vendor.zip，用zip -r（Linux/macOS）或 7-Zip（Windows，选“存储”模式）保证符号链接和权限不损坏 - 上传到离线服务器项目根目录，解压后执行：
chown -R www:www vendor/（假设 Web 进程用户为www） - 检查
vendor/autoload.php是否存在且可读；若入口文件路径有调整（如public/不在项目根下一级），务必同步修正require __DIR__ . '/../vendor/autoload.php';
漏掉 chown 或路径写错，是内网部署失败最常见的两个原因。
离线环境容易被忽略的关键配置
即使 vendor 完整、缓存可用，仍可能卡在 SSL 验证或 PHP 扩展缺失上。
-
openssl.cafile和curl.cainfo必须指向有效的 CA 证书路径，否则连本地仓库也会失败；临时方案：export COMPOSER_DISABLE_TLS=1（仅限可信内网） - 确认
ext-zip、ext-json、ext-openssl已启用，memory_limit不低于 512M（composer install解压大包时容易爆内存） - 如果用了自定义本地仓库（如 Nginx 挂载的
/packages/），必须提前生成packages.json，且所有依赖必须锁定具体版本号（dev-master类引用不支持）
真正麻烦的从来不是“怎么装”，而是“为什么装完还报错”——多数时候错在 PHP 配置、用户权限或路径硬编码，而不是 Composer 本身。
