composer 中文项目迁移失败的根本原因是 composer.lock 与新环境不匹配，需验证平台要求、校验锁文件合法性、清理 vendor 并重装，同时正确配置镜像源。
Composer 中文项目迁移时，最常卡在 composer install 失败或依赖解析死循环——根本原因不是网络，而是 composer.lock 里记录的包来源、版本哈希、平台配置与新环境不匹配。
导出时别只跑 composer dump-autoload，先确认锁文件是否可信
很多团队直接把旧项目的 composer.lock 复制过去，结果在新机器上 composer install 报 Package operations: 0 installs, 0 updates, 0 removals 却缺类——因为 lock 文件里记录的是旧 PHP 版本、旧扩展（比如 ext-intl）、甚至旧 packagist 镜像源地址。导出前必须验证 lock 文件是否与目标环境兼容：
- 用
composer check-platform-reqs检查当前环境是否满足 lock 文件声明的 PHP 和扩展要求 - 运行
composer validate确保 lock 文件语法合法（尤其注意中文路径或注释导致的 JSON 解析失败） - 如果项目曾用过
composer config repo.packagist composer https://packagist.phpcomposer.com这类已失效镜像，lock 文件里仍保留旧 URL，必须重生成
composer install 卡住？优先清空 vendor + 强制重装
迁移后首次安装，不要迷信“保留 vendor 目录省时间”。vendor 里混着旧 autoloader 映射、旧二进制脚本、甚至旧扩展的 .so 文件，会干扰新环境加载。标准流程是：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 删掉整个
vendor/目录和composer.phar（如果本地有） - 确保
composer.json中的"platform"配置与目标环境一致（例如 PHP 8.1 项目却写了"php": "7.4.0"，会导致某些包降级） - 运行
composer install --no-dev --optimize-autoloader（生产环境跳过 dev 依赖，加速且避免测试工具冲突） - 若仍卡在某个包（如
overtrue/wechat），加-vvv查看真实错误，大概率是该包 require 的 ext-curl 或 ext-json 版本不匹配
国内环境别硬刚 packagist.org，换源要改两处
单纯执行 composer config -g repo.packagist composer https://packagist.phpcomposer.com 已失效。现在主流镜像（阿里、腾讯、华为）要求同时替换主源和包下载源：
- 全局设置：运行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 但部分包（尤其是私有包或 GitHub 直链）仍走默认下载逻辑，需额外设
composer config -g fxp-asset-api-github-com "https://github.com"并配合composer config -g github-oauth github.com your_token（如有私有仓库） - 更稳妥的方式是改
composer.json顶层加"repositories"块，把镜像源写死，避免不同机器全局配置不一致
真正耗时的从来不是下载速度，而是 lock 文件隐含的平台约束和历史镜像残留。每次迁移前花两分钟检查 composer.lock 里的 platform 字段和 packages 数组里的 dist URL，比反复重试 install 有效得多。
