如何使用Composer管理跨多个项目的共享本地库？（symlink与path仓库）

推荐使用 Composer 的 path 仓库方式管理跨项目本地共享库，通过配置 "repositories" 为 path 类型并启用 "symlink": true，使 vendor 中的包符号链接至本地源码，确保修改即时生效且可复现；手动 symlink 方式存在被覆盖、autoload 失效等风险，仅适用于临时调试。

用 Composer 管理跨项目的本地共享库，核心是让多个项目能直接引用你本地开发中的库代码，且无需反复 install/push/pull。最实用、最轻量的两种方式是：path 仓库（推荐） 和 软链接（symlink，需谨慎）。前者更稳定、可复现；后者适合极快速调试，但容易出环境问题。

用 path 仓库实现本地库自动映射

这是官方推荐、项目间协作友好的方式。Composer 会把本地路径当作一个“虚拟包仓库”，只要路径下有合法的 composer.json，就能被其他项目 require 并自动 symlink 到 vendor/ 中（前提是启用了 local repos 和 path 类型）。

• 在你的本地库目录（如 ~/code/my-shared-lib）中确保有完整 composer.json，包含 "name"（如 "acme/shared-lib"）、"version"（如 "dev-main" 或 "1.0.x-dev"）等基础字段
• 在使用该项目的主应用的 composer.json 中添加：

"repositories": [
  {
    "type": "path",
    "url": "../my-shared-lib",
    "options": {
      "symlink": true
    }
  }
],
"require": {
  "acme/shared-lib": "dev-main"
}

• 运行 composer update acme/shared-lib，Composer 会创建符号链接（不是复制），修改库代码后主项目立即可见
• "symlink": true 是关键——它让 vendor 中的包指向源码目录；若设为 false，则会复制一份（不推荐用于开发）
• 该配置可提交到 Git，团队成员只要本地有对应路径，就能一键启用（路径可相对，也可用环境变量如 ${HOME}/code/...）

手动 symlink 的适用场景与风险

不通过 Composer 配置，而是手动在 vendor/ 下建 symlink，仅建议用于临时验证或 CI 调试，不适合日常开发或协作。

标签： linux js git json composer windows mac ai macos 环境变量 win cos