如何缩小node_modules体积？私有NPM包致体积暴涨问题咨询

首先明确：正常情况下，私有包的devDependencies不会被安装到你的项目node_modules中——npm默认只会安装包的dependencies字段里的依赖。所以体积暴增大概率不是因为devDependencies，除非你把开发依赖错误放到了dependencies里，或者发布包时带了冗余文件。

下面是具体的排查和优化步骤：

1. 先定位体积暴涨的具体原因 #

用工具分析私有包的体积构成，快速找到问题点：

• 执行npx ls-lint查看node_modules中各个包的大小，确认是私有包本身代码大，还是它依赖的第三方包多；
• 执行npx source-map-explorer node_modules/[你的私有包名]/dist/**/*.js（如果包有打包产物）分析包内代码的体积占比，排查是否有冗余模块。

2. 检查私有包的依赖配置 #

• 别把开发依赖放到dependencies里：如果你的私有包把webpack、babel、eslint这类仅开发时用的工具写在了dependencies而非devDependencies，安装这个包时这些工具会被强制下载，直接导致体积暴涨。立刻把它们移到devDependencies里，重新发布包。
• 替换轻量依赖：检查dependencies里的包，是否有可以用轻量替代的选项，比如用dayjs替代moment，用lodash-es替代完整的lodash，或者只引入需要的子模块（如lodash/cloneDeep）。
• 用peerDependencies共享依赖：如果私有包依赖react、vue这类宿主项目大概率已有的库，把它们设为peerDependencies，这样宿主项目不会重复下载相同版本的依赖，减少体积。

3. 优化私有包的打包输出 #

• 开启生产模式打包：用webpack/rollup打包私有包时，一定要开启production模式，开启tree-shaking、代码压缩、移除调试代码（如console.log），大幅减小产物体积。
• 避免打包第三方依赖：不要把私有包依赖的第三方库打包进产物里，让npm去管理这些依赖，这样宿主项目可以共享依赖，减少重复下载。

4. 清理发布包的冗余文件 #

• 检查私有包的.npmignore文件或package.json的files字段，确保只发布必要的文件：比如只发布打包后的dist目录、package.json、README，不要把src源码、测试文件、本地的node_modules、文档等冗余文件发布上去。很多时候体积暴涨就是因为不小心把私有包自己的node_modules也发布了。

5. 安装时的额外优化 #

• 用生产模式安装：

npm install [你的私有包名] --production

这个命令会确保只安装生产必需的依赖，避免宿主项目自己的devDependencies被安装（不过对私有包的依赖来说，默认已经不会安装它的devDependencies）。

• 换用pnpm或yarn：它们的依赖复用机制（硬链接）可以大幅减少重复依赖的体积，尤其是当项目有多个包共享依赖时。

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