将多个类库包合并为单一Node.js包 并统一项目类库版本

我来给你一套清晰的步骤，完美解决你想要在多项目中强制使用特定版本类库，同时将常用包合并为单一Node.js包的需求：

1. 搭建你的聚合依赖包 #

首先我们要创建一个专门的包，用来封装所有你需要统一版本的类库，确保所有项目都复用这一套依赖：

• 新建一个文件夹（比如叫shared-react-stack），初始化npm项目：

  mkdir shared-react-stack && cd shared-react-stack
  npm init -y
  

• 安装指定版本的依赖，注意这里不要加^或~，确保版本完全固定：

  npm install react@16.3.2 react-dom@16.3.2 react-router@4.2.0 react-router-dom@4.2.2
  

• 在项目根目录创建index.js，把所有依赖导出，方便项目直接引用：

  // CommonJS导出方式
  module.exports = {
    React: require('react'),
    ReactDOM: require('react-dom'),
    ReactRouter: require('react-router'),
    ReactRouterDOM: require('react-router-dom')
  };
  
  // ES模块导出方式（可选）
  // export { default as React } from 'react';
  // export { default as ReactDOM } from 'react-dom';
  // export { default as ReactRouter } from 'react-router';
  // export { default as ReactRouterDOM } from 'react-router-dom';
  

2. 让项目依赖这个聚合包 #

根据你的使用场景，有两种方式让项目接入：

开发阶段：本地链接 #

如果你只是自己开发测试，可以用npm link快速关联：

• 在聚合包目录执行：

  npm link
  

• 然后在每个项目目录执行：

  npm link shared-react-stack
  

这样项目会直接使用本地的聚合包，所有依赖版本完全一致。

团队协作：发布到私有仓库 #

如果是团队共用，把聚合包发布到私有npm仓库（比如Verdaccio、公司内部的npm源），然后在每个项目的package.json里添加依赖：

"dependencies": {
  "shared-react-stack": "1.0.0" // 用精确版本，避免意外更新
}

执行npm install后，项目就会安装这个聚合包，同时自动拉取它依赖的固定版本类库。

3. 强制锁定版本，防止冲突 #

为了彻底杜绝项目中出现其他版本的这些类库，可以在项目的package.json里添加版本强制规则：

对于npm 8+版本： #

添加overrides字段，强制替换所有间接依赖的版本：

"overrides": {
  "react": "16.3.2",
  "react-dom": "16.3.2",
  "react-router": "4.2.0",
  "react-router-dom": "4.2.2"
}

对于Yarn用户： #

添加resolutions字段：

"resolutions": {
  "react": "16.3.2",
  "react-dom": "16.3.2",
  "react-router": "4.2.0",
  "react-router-dom": "4.2.2"
}

这样哪怕有第三方依赖间接引入了不同版本的类库，也会被强制替换成你指定的版本。

4. 在项目中使用聚合包 #

现在你可以在项目代码里直接从聚合包导入，不用再单独安装每个类库：

// CommonJS方式
const { React, ReactDOM, ReactRouterDOM } = require('shared-react-stack');

// ES模块方式
import { React, ReactDOM, ReactRouterDOM } from 'shared-react-stack';

这样所有项目都会统一使用你预定的类库版本，再也不用担心版本不一致的问题啦！

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