如何不使用符号链接安装本地npm模块？场景及方案咨询

我之前在本地开发多包项目时也碰到过一模一样的问题，给你分享两个能完美解决需求的方案，还能结合peerDependencies一起使用：

方案一：不使用符号链接，完整安装本地模块及其依赖 #

这个方案会把本地模块的文件复制到my-app的node_modules里，同时自动安装模块自身的依赖，完全避免符号链接的问题：

• 先切换到my-module目录，执行打包命令生成本地安装包：

cd /my-module
npm pack

这会在my-module目录下生成一个类似my-module-1.0.0.tgz的压缩包（版本号对应你package.json里的version字段）。

• 回到my-app目录，安装这个本地包：

cd /my-app
npm install ../my-module/my-module-1.0.0.tgz

安装完成后，my-app的node_modules里会出现myModule的完整文件，且my-module的依赖也会被正常安装。

• （可选）为了方便后续更新，你可以在my-app的package.json里加一个npm脚本：

"scripts": {
  "update:local-module": "cd ../my-module && npm pack && cd ../my-app && npm install ../my-module/my-module-*.tgz"
}

以后每次修改my-module后，只需要跑npm run update:local-module就能同步更新。

结合peerDependencies使用 #

在my-module的package.json里配置peerDependencies，比如：

"peerDependencies": {
  "react": "^18.0.0",
  "lodash": "^4.17.0"
}

这样安装时，npm会检查my-app是否已经安装了符合版本要求的依赖，不会重复安装这些包，完全符合peerDependencies的设计初衷。

方案二：使用符号链接，同时解决依赖缺失问题 #

如果想保留符号链接（方便开发时实时同步代码修改），可以用npm的**工作区（Workspaces）**功能来管理，它会自动处理依赖共享，避免符号链接下依赖缺失的问题：

• 在my-module和my-app的父目录下创建一个package.json，配置工作区：

{
  "name": "my-monorepo",
  "private": true,
  "workspaces": [
    "my-module",
    "my-app"
  ]
}

• 在父目录下执行npm install，这会自动完成以下操作：

  • 把my-module以符号链接的形式安装到my-app的node_modules里
  • 统一安装所有工作区包的依赖（包括my-module的依赖，会放在父目录的node_modules里，由所有包共享）

• 在my-app的package.json的dependencies里添加：

"dependencies": {
  "myModule": "*"
}

npm会自动关联工作区里的my-module，无需写相对路径。

结合peerDependencies使用 #

同样在my-module的package.json里配置peerDependencies，npm在安装时会自动检查my-app是否满足依赖要求，确保依赖版本一致，不会重复安装。

额外小提示 #

• 如果你不想用工作区，也可以先在my-module目录下执行npm install装好自身依赖，再在my-app里执行npm install ../my-module，虽然是符号链接，但my-module自己的node_modules是存在的，my-app调用模块时会优先读取my-module目录下的依赖。不过工作区的方式更规范，适合长期维护。
• 使用peerDependencies时，建议明确版本范围，避免出现版本冲突导致的兼容问题。

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