为了将 main 与测试编译分开，需要设置哪些正确的 typescript 编译器 (tsc) 选项？

Question

注意：如果您想查看完整项目，此问题的公共 git 存储库位于 https://github.com/matthewadams/ts-test。

我正在尝试将项目中的主要源代码编译与测试源代码编译分开。这是源目录结构：

src
  main
    ...typescript source files and possibly child directories with sources
  test
    unit
      ...unit test sources
    integration
      ...integration test sources

我的目标是将仅主要源代码编译成lib/main，仅将测试源代码编译成lib/test。

我正在尝试将主编译和测试编译应该通用的所有编译器选项放在tsconfig.json 中，然后使用命令行参数到tsc 来提供特定于每个编译的选项。这是我目前的tsconfig.json：

{
  "compilerOptions": {
    "strict": true,
    "alwaysStrict": true,
    "diagnostics": true,
    "disableSizeLimit": true,
    "esModuleInterop": true,
    "extendedDiagnostics": true,
    "forceConsistentCasingInFileNames": true,
    "inlineSourceMap": true,
    "inlineSources": true,
    "listEmittedFiles": true,
    "listFiles": true,
    "module": "commonjs",
    "pretty": true,
    "target": "es2015"
  }
}

来自package.jsonscripts 部分的 sn-p 如下（我拒绝 Gulp、Grunt 等，理由是复杂性，故意牺牲可移植性）：

  "scripts": {
    "transpile-main": "rm -rf lib/main && tsc --outDir lib/main --rootDir src/main -d --declarationDir lib/main",
    "transpile-test": "rm -rf lib/test && tsc --outDir lib/test --rootDir src/test --typeRoots lib/main",
    ...other scripts here...
  }

我可以毫无问题地编译主要源代码，它们正确出现在lib/main 中。但是，当我编译测试源时，出现以下错误：

$ npm run transpile-test

> @matthewadams/ts-test@0.1.0-pre.0 transpile-test /Users/matthewadams/dev/me/ts-test
> rm -rf lib/test && tsc --outDir lib/test --rootDir src/test --typeRoots src/main

error TS6059: File '/Users/matthewadams/dev/me/ts-test/src/main/Nameable.ts' is not under 'rootDir' 'src/test'. 'rootDir' is expected to contain all source files.

error TS6059: File '/Users/matthewadams/dev/me/ts-test/src/main/Person.ts' is not under 'rootDir' 'src/test'. 'rootDir' is expected to contain all source files.

error TS6059: File '/Users/matthewadams/dev/me/ts-test/src/main/PersonImpl.ts' is not under 'rootDir' 'src/test'. 'rootDir' is expected to contain all source files.

让我感到困惑的是消息'rootDir' is expected to contain all source files. 我正在尝试根据lib/main 中的内容编译测试源。我不希望所有资源都在一个目录下。

tsconfig.json 选项和tsc cli 选项的正确组合是什么，以实现我的分开主编译和测试编译的目标？

Answer 1

错误：“rootDir”应包含所有源文件。

rootDir 应该是所有源/输入文件的根。 TS 编译器是这样进行的：

collect all input files ("files" / "include" / "exclude" / imports) 
  --> for each included input file
    --> chop off the "rootDir" from the input 
    --> prepend the "outDir"

src/test文件是从src/main导入的，所以目前rootDir只能设置为src或以上。

解决方案：项目参考 (TS 3.0+)

Project references可以解决你描述的所有问题：

• rootDir 将分别设置为 src/main 或 src/test
• src 文件夹不会作为 lib 输出的一部分出现
• src/main 无法导入 src/test（反之亦然）

生成的项目结构：

|   tsconfig-base.json            // other config options go here
|   tsconfig.json                 // solution config containing references
|   
+---lib                           // output folder
|   +---main
|   |       mod.d.ts
|   |       mod.js
|   |       tsconfig.tsbuildinfo
|   |       
|   \---test
|           mod-test.js     
\---src
    +---main                      // referenced sub-project main 
    |       mod.ts
    |       tsconfig.json
    |       
    \---test                      // referenced sub-project test 
            mod-test.ts
            tsconfig.json

./tsconfig-base.json:

{
  "compilerOptions": {
    // just some sample values, set your own as needed
    "target": "ESNext",
    "module": "ESNext",
    "moduleResolution": "node",
    "strict": true,
    "esModuleInterop": true,
    // other compiler options
  }
}

./tsconfig.json：

{
  "files": [],
  "references": [
    {
      "path": "./src/main"
    },
    {
      "path": "./src/test"
    }
  ]
}

./src/main/mod.ts：

export const foo = "foo";

./src/main/tsconfig.json：

{
  "extends": "../../tsconfig-base.json",
  "compilerOptions": {
    "outDir": "../../lib/main",
    "composite": true // flag to signal referenced project      
  }
}

./src/test/mod-test.ts：

import { foo } from "../main/mod";

// use your test framework here
export function testMod() {
  if (foo !== "foo") throw new Error("foo expected.");
}

testMod()

./src/test/tsconfig.json：

{
  "extends": "../../tsconfig-base.json",
  "compilerOptions": {
    "outDir": "../../lib/test"
  },
  "references": [
    {
      "path": "../main" // test project depends on main
    }
  ]
}

您可以使用以下scripts 构建和清理项目：

"scripts": {
    "build": "tsc -b -v",
    "clean": "tsc -b --clean"
},

更多链接

• TypeScript Project References Demo