如何实现NPM按环境安装同一包：生产用GitHub，开发用本地链接

核心需求实现思路 #

要实现「开发环境用本地源码软链调试，生产环境拉取GitHub仓库包」，同时避免开发者误提交依赖配置，推荐以下几种方案：

方案1：npm link（最稳妥，无需修改package.json） #

• 保持package.json仅配置生产依赖源：

  "dependencies": {
    "myPackage": "github:mygithub/mypackage"
  }
  

• 开发调试步骤：
  1. 进入本地mypackage源码目录，执行 npm link
  2. 回到项目目录，执行 npm link myPackage
     此时项目会自动软链到本地源码，修改后实时生效，且package.json完全不用改动，从根源避免提交错误。
• 生产环境直接执行 npm install --production，会正常拉取GitHub上的正式包。

方案2：npm overrides（适合团队统一配置） #

如果需要在配置中固定开发环境的依赖源，可使用npm 8.3.0+支持的overrides特性：

"dependencies": {
  "myPackage": "github:mygithub/mypackage"
},
"overrides": {
  "myPackage": "file:./../mypackage"
}

• 执行默认的npm install（开发环境）时，会自动使用本地文件路径并创建软链；
• 执行npm install --production时，overrides会被忽略，直接安装GitHub版本。

方案3：脚本化切换（适配复杂场景） #

在package.json中添加脚本，统一管理安装命令：

"scripts": {
  "install:dev": "npm install && npm link ../mypackage",
  "install:prod": "npm install --production"
}

• 开发时运行 npm run install:dev，一键完成安装+本地软链；
• 生产环境运行 npm run install:prod，直接安装生产依赖。

你当前配置的问题说明 #

你把同一个包同时放在dependencies和devDependencies中，npm默认会优先加载dependencies里的版本（除非用--only=dev参数）。如果生产环境执行npm install --production没安装myPackage，大概率是缓存干扰或npm版本兼容问题，可尝试清理缓存后重试：

npm cache clean --force && npm install --production

内容的提问来源于stack exchange，提问作者cranky-old-guy-rick