Composer中文环境下的Vendor目录冷热数据分离方案设计-composer-PHP中文网

vendor目录在中文环境易出冷热混杂问题，因中文项目常引入含大量文档、测试、语言包的依赖（如overtrue/laravel-lang），这些冷数据被默认纳入autoload扫描范围，拖慢dump-autoload -o及运行时加载；应通过autoload-dev隔离非运行时路径、移除主autoload中resources/lang等映射，并配合启动时动态注册语言路径实现冷热分离。

composer中文环境下的vendor目录冷热数据分离方案设计

为什么 vendor 目录在中文环境里更容易出冷热混杂问题

因为 Composer 默认用 vendor 目录存放所有依赖，而中文项目常混用大量带中文文档、测试用例、本地化资源的包（比如 overtrue/laravel-lang、symfony/translation），这些内容体积大、访问频次低，却和核心代码一起被加载进内存或参与构建。PHP 的 autoloader 不区分路径热度，只要在 autoload 配置里，就全量扫描 —— 这直接拖慢 composer dump-autoload -o 和运行时类加载。

如何用 autoload-dev + 自定义 PSR-4 命名空间隔离冷数据

把文档、测试、语言包等非运行时必需内容，从主 autoload 移出，改由 autoload-dev 管理，并配合独立命名空间避免冲突：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

在 composer.json 中移除原 autoload 里对 resources/lang 或 docs 的 PSR-4 映射

新增 autoload-dev 段，只映射开发期才需加载的路径：

"autoload-dev": {
  "psr-4": {
    "Lang\": "vendor/overtrue/laravel-lang/src/",
    "Docs\": "vendor/doctrine/orm/docs/"
  }
}

确保生产环境执行 composer install --no-dev，此时 autoload-dev 内容不会写入 vendor/autoload.php，也不会出现在 composer dump-autoload -o 生成的优化文件中

用 symlink + .gitignore 控制 vendor 下语言包的物理位置

很多中文项目把 zh_CN 翻译文件硬塞进 vendor 子目录，导致每次 composer update 都可能被覆盖。正确做法是让翻译资源脱离 vendor 目录树：

新建 resources/lang-vendor 目录，把需要保留的中文语言包复制进去
删除 vendor/xxx/package/resources/lang/zh_CN（如果存在）

在 composer.json 的 extra 中声明自定义路径：

"extra": {
  "laravel-lang-path": "../resources/lang-vendor"
}

在应用启动时（如 Laravel 的 AppServiceProvider）手动添加该路径：

app('translator')->addResource('php', base_path('resources/lang-vendor'), 'zh_CN');

把 vendor/**/resources/lang 加进 .gitignore，防止提交第三方语言文件

注意 composer.lock 文件不记录 symlink 变更

如果你用 ln -s 把 resources/lang-vendor 挂载到 vendor/xxx/lang，composer.lock 完全感知不到这个软链 —— 它只锁版本号和哈希值。一旦团队成员没手动建链，或 CI 环境未执行 ln -s 步骤，运行时就会报 Class LangZhCnTranslator not found 或找不到语言文件。真正可靠的方案是：不依赖 symlink，而是靠 autoload-dev + 启动时动态注册路径，把“冷数据在哪里”这件事彻底交给 PHP 层控制，而不是文件系统层。