如何使用NX构建仅含所需依赖的独立包及生成单可执行文件？

一、给每个子包配置专属node_modules并独立构建 #

要实现单包仅安装自身依赖，核心是关闭NX的依赖提升，同时给每个子包配置独立的package.json：

1. 拆分package.json
   在每个子包目录（如packages/pkg-a）下创建独立的package.json，仅声明该包运行和构建所需的dependencies、devDependencies；根目录的package.json只保留NX全局依赖（如nx、@nx/workspace等）。

2. 关闭NX依赖提升
   在根目录的nx.json中修改任务运行器配置，禁用hoisting：

   {
     "tasksRunnerOptions": {
       "default": {
         "options": {
           "hoist": false
         }
       }
     }
   }
   

3. 安装单包依赖

   • 直接进入子包目录执行npm install，依赖会安装在子包的node_modules中；
   • 或用NX统一命令：nx run [包名]:install；
   • 更推荐用pnpm（天生适配多包）：pnpm install --filter [包名]，依赖会存在全局存储，子包仅通过软链引用，体积更小、安装更快。

4. 独立构建单包
   执行nx build [包名]，此时构建只会使用该子包专属的node_modules，不会加载根目录的全量依赖。

二、打包为包含所有依赖的单可执行main.js #

如果上述方案无法满足需求，可将所有依赖打包进单个文件，分两种场景处理：

Node.js项目 #

• 用Webpack打包
  在子包目录创建webpack.config.js：

  const path = require('path');
  
  module.exports = {
    entry: './src/main.js',
    target: 'node',
    output: {
      path: path.resolve(__dirname, 'dist'),
      filename: 'main.js',
      libraryTarget: 'commonjs2'
    },
    mode: 'production',
    externals: {
      // 排除Node.js核心模块（如fs、path），无需打包
    }
  };
  

  修改子包的project.json，将build任务指向该Webpack配置，执行nx build [包名]即可生成单文件。

• 用pkg生成可执行文件
  先完成常规构建，再安装pkg：npm install -g pkg，然后执行：

  pkg ./dist/main.js --output main
  

  生成的main文件是可执行二进制文件，无需额外依赖。

前端项目 #

修改子包的NX构建配置（project.json），确保Webpack/Vite将所有依赖打包进单个文件：

• 开启outputHashing: none避免文件名哈希；
• 配置Webpack的entry为项目入口，关闭代码分割（如需单文件）；
• 执行nx build [包名]后，dist目录下的main.js会包含所有依赖。

三、关于拆分package.json后仍加载根依赖的问题 #

这是因为NX默认开启了依赖提升（hoisting），会将所有子包的依赖提升到根目录node_modules。只需按照上面的步骤关闭hoisting，同时确保子包的package.json依赖声明完整，就能强制构建工具使用子包专属的依赖目录。

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