使用npm link多项目协作：团队如何获取未发布的本地共享模块？

你遇到的核心问题是npm link仅能在本地建立软链，无法同步到远程仓库——软链指向的是你本地的文件路径，其他成员拉取代码后既没有对应本地文件，也没有明确的依赖声明，自然找不到共享代码。改软链到node_modules外并不是最优解，反而会破坏Node.js默认的模块解析逻辑，推荐用以下几种规范方案：

方案1：将共享包作为Git依赖引入 #

把你的共享文件夹做成独立的Git仓库，然后在主项目的package.json里直接添加该仓库作为依赖：

"dependencies": {
  "your-shared-package": "git+ssh://git@your-team-repo/your-shared-package.git#dev-branch"
}

团队成员执行npm install时，会自动拉取这个Git仓库的代码到node_modules；后续共享包更新后，只要推送Git仓库，成员执行npm update your-shared-package就能同步最新代码。

方案2：使用本地相对路径依赖（适合临时协作） #

如果不想单独建Git仓库，可以直接在主项目的package.json里用本地路径声明依赖：

"dependencies": {
  "your-shared-package": "file:../path/to/your-shared-folder"
}

这种方式要求团队成员的本地目录结构和你完全一致，否则会找不到依赖。npm install时会自动在node_modules建立软链（或复制文件，取决于npm版本），不用手动执行npm link。

方案3：采用Monorepo工作区（长期协作最优解） #

如果是长期的多项目共享场景，直接用npm/yarn的workspaces功能搭建Monorepo：

1. 根目录创建package.json，配置workspaces：

{
  "name": "your-monorepo",
  "private": true,
  "workspaces": [
    "packages/shared",
    "apps/project-a",
    "apps/project-b"
  ]
}

2. 把共享代码放到packages/shared目录，各个业务项目放到apps/目录下
3. 每个业务项目的package.json里正常声明共享包依赖：

"dependencies": {
  "your-shared-package": "^1.0.0"
}

团队成员拉取整个Monorepo后，执行npm install，npm会自动处理所有包的依赖关联，不需要手动npm link，而且依赖关系清晰，便于统一管理版本。

至于你提到的“把软链改到node_modules以外”：Node.js默认会从node_modules目录查找模块，改到其他目录需要手动设置NODE_PATH环境变量，或者在所有导入路径里写绝对/相对路径，不仅麻烦还容易出错，完全没必要用这种方式。

内容的提问来源于stack exchange，提问作者rionalab