npm install本地库未创建软链接，仅复制文件至node_modules

• 确保本地包目录存在package.json：../library/dist/component-library目录下必须包含完整的package.json文件，npm仅会对包含合法package.json的目录创建软链接，否则会直接复制文件内容。

• 修正依赖配置：JSON中重复的key会被自动覆盖，保留一种正确的路径配置即可：

  {
    "dependencies": {
      "@org/my-library": "file:../library/dist/component-library"
    }
  }
  

• 使用npm link手动创建软链（推荐）：

  1. 进入本地包目录：

     cd ../library/dist/component-library
     

  2. 注册本地包到npm全局链接：

     npm link
     

  3. 在项目目录中链接该包：

     npm link @org/my-library
     

     这样修改本地库并重建后，项目的node_modules中会直接同步最新代码。

• 检查npm链接配置：
  查看当前npm的link配置状态：

  npm config get link
  

  如果返回false，执行以下命令开启链接功能：

  npm config set link true
  

• 清除npm缓存：
  缓存可能导致旧文件残留，执行缓存清理后重新操作：

  npm cache clean --force
  

• 替代工具尝试：
  若npm始终无法正常创建软链，可以换用yarn或pnpm，这两个包管理器对本地依赖的软链支持更稳定，配置方式类似：

  {
    "dependencies": {
      "@org/my-library": "file:../library/dist/component-library"
    }
  }
  

  直接执行yarn install或pnpm install即可自动创建软链接。

内容的提问来源于stack exchange，提问作者Get Off My Lawn