如何让NestJS构建后在dist生成独立文件并保留项目结构？

要实现编译后生成独立的.js和.d.ts文件并保留原有项目结构，需要从Nest编译配置和TypeScript配置两方面调整：

1. 调整Nest CLI配置（禁用Webpack打包） #

Nest默认可能使用Webpack将代码打包为单文件，需切换回TypeScript原生编译模式：

修改项目根目录下的nest-cli.json，确保compilerOptions中指定使用tsc构建器：

{
  "$schema": "https://json.schemastore.org/nest-cli",
  "collection": "@nestjs/schematics",
  "sourceRoot": "src",
  "compilerOptions": {
    "deleteOutDir": true,
    "builder": "tsc",
    "typeCheck": true,
    "tsConfigPath": "./tsconfig.json"
  }
}

2. 修正TypeScript配置（tsconfig.json） #

你的现有配置存在几个关键问题，调整如下：

{
  "compilerOptions": {
    "rootDir": "./src", // 指定源码根目录为src，确保编译范围正确
    "sourceMap": true,
    "declaration": true, // 启用生成.d.ts类型声明文件
    "moduleResolution": "node",
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true,
    "importHelpers": true,
    "target": "es2015",
    "module": "commonjs",
    "lib": ["es2017", "dom"],
    "skipLibCheck": true,
    "skipDefaultLibCheck": true,
    "baseUrl": "./",
    "outDir": "./dist", // 指定输出目录为项目根目录下的dist
    "types": ["node"]
  },
  "include": ["src/**/*"], // 明确只编译src下的所有文件
  "exclude": ["node_modules", "dist"] // 排除不需要编译的目录
}

关键调整说明：

• rootDir设为./src：避免编译根目录下的非源码文件，确保输出结构与src一致
• outDir设为./dist：让编译产物直接输出到项目根目录的dist文件夹
• 添加include和exclude：明确编译范围，避免冗余文件

3. 执行编译 #

运行以下命令执行编译：

nest build

或直接调用TypeScript编译器：

tsc

验证结果 #

编译完成后，查看dist目录，你会看到与src完全一致的文件夹结构，每个.ts源码文件对应生成：

• .js：编译后的JavaScript文件
• .d.ts：类型声明文件
• .js.map：源映射文件（如果sourceMap为true）

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