npm link 覆盖同@前缀包问题及正确分组方式咨询

这是预期行为吗？ #

是预期行为。npm link 处理带Scope（@前缀）的包时，会把整个Scope目录（比如这里的@test）作为一个软链接对象。第一次执行npm link @test/pkg1时，npm会在项目的node_modules下创建@test软链接，指向全局的@test/pkg1所在的Scope目录；第二次执行npm link @test/pkg2时，npm会替换这个@test软链接的指向，改为指向全局的@test/pkg2的Scope目录，导致之前的pkg1无法被访问。

同一机构/项目的包如何正确分组？ #

可以用以下几种方式解决：

方法1：直接link包的本地路径 #

跳过全局link步骤，直接在项目目录中执行：

npm link ../path/to/pkg1
npm link ../path/to/pkg2

npm会自动在项目的node_modules/@test下创建pkg1和pkg2两个子目录的软链接，不会出现覆盖问题。

方法2：手动创建Scope目录后单独link #

1. 先在项目的node_modules下创建Scope目录：

   # Linux/macOS
   mkdir -p node_modules/@test
   # Windows
   mkdir node_modules\@test
   

2. 进入pkg1目录，执行：

   npm link ../your-project/node_modules/@test/pkg1
   

3. 进入pkg2目录，执行：

   npm link ../your-project/node_modules/@test/pkg2
   

这样两个包会分别链接到@test目录下的对应子目录，互不影响。

方法3：使用npm Workspaces（推荐，适合多包项目） #

如果你的pkg1和pkg2属于同一个项目仓库（Monorepo），可以用npm Workspaces来管理：

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

   {
     "name": "@test/monorepo",
     "private": true,
     "workspaces": [
       "packages/pkg1",
       "packages/pkg2"
     ]
   }
   

2. 把pkg1和pkg2放到根目录的packages子目录下
3. 在根目录执行npm install，npm会自动处理包之间的依赖关系，在根目录的node_modules/@test下生成两个包的链接，无需手动执行npm link，后续维护也更方便。

方法4：全局link后用npm install安装 #

先分别在pkg1和pkg2目录执行npm link完成全局链接，然后在项目目录执行：

npm install @test/pkg1 @test/pkg2

npm会在node_modules/@test下创建两个包的软链接，指向全局的对应包，不会出现覆盖问题。

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