如何解决postinstall.ts未纳入tsconfig时的报错与编译冲突问题

针对你的需求（仅编译src到build目录，同时让postinstall.ts获得类型提示且不触发配置报错），提供三种可行方案：

方案1：为postinstall.ts创建独立的TypeScript配置文件 #

这是最规范的做法，既不影响主编译流程，又能让工具正确识别postinstall.ts的类型。

在项目根目录新建tsconfig.postinstall.json，内容如下：

{
  "compilerOptions": {
    "target": "esnext",
    "skipLibCheck": true,
    "strict": true,
    "module": "commonjs",
    "esModuleInterop": true,
    "typeRoots": ["./node_modules/@types"]
  },
  "include": ["postinstall.ts"]
}

编辑器（如VS Code）会自动识别多配置文件，postinstall.ts将使用这个独立配置获得类型提示，主tsconfig.json保持原有配置不变，完全避免rootDir冲突问题。

方案2：手动补全postinstall.ts的类型声明（简洁快速） #

如果不想新增配置文件，只需两步操作：

1. 确保已安装Node.js类型依赖：

   npm install @types/node --save-dev
   

2. 在postinstall.ts顶部添加以下声明，解决__dirname和内置模块的类型问题：

   declare const __dirname: string;
   

此时无需将postinstall.ts加入主tsconfig.json的include字段，编辑器就能正确识别类型，不再报错。

方案3：调整主配置（不推荐） #

若一定要将postinstall.ts加入主配置的include，需修改rootDir并调整编译命令：

• 修改tsconfig.json的关键配置：

  {
    "compilerOptions": {
      // ...其他配置不变
      "rootDir": ".",
      "baseUrl": ".",
      "paths": {
        "@/*": ["./src/*"]
      }
    },
    "include": ["src", "postinstall.ts"],
    "exclude": ["node_modules", "build"]
  }
  

• 编译时仅指定src目录：

  tsc --project tsconfig.json --outDir build src/**/*
  

这种方法会让配置复杂度提升，且容易误编译postinstall.ts，仅作为备选方案。

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