编译器选项

在使用 MSBuild 构建 TypeScript 项目时，可以通过配置 TypeScript 编译器选项（Compiler Options）来指定编译器的行为和输出。这些选项可以在项目文件（例如 .csproj 文件）中进行配置，以控制 TypeScript 编译器在构建过程中的行为。

TypeScript 编译器选项

TypeScript 的编译器选项可以通过配置文件（通常是 tsconfig.json）或者在 MSBuild 项目文件中直接指定。以下是一些常见的 TypeScript 编译器选项，它们可以通过 MSBuild 配置来控制：

OutDir
设置输出目录，指定编译后 JavaScript 文件的输出位置。
```
<TypeScriptOutDir>wwwroot/js</TypeScriptOutDir>
```
SourceMap
是否生成 source map 文件，用于在调试时将编译后的 JavaScript 代码映射回 TypeScript 源代码。
```
<TypeScriptSourceMap>true</TypeScriptSourceMap>
```
ModuleResolution
指定模块解析策略，可以是 node（Node.js 模块解析策略）或 classic（经典模块解析策略）。
```
<TypeScriptModuleResolution>node</TypeScriptModuleResolution>
```
Target
指定 ECMAScript 目标版本，例如 ES5、ES6 等。
```
<TypeScriptTarget>ES5</TypeScriptTarget>
```
NoEmitOnError
如果有 TypeScript 编译错误，是否终止生成 JavaScript 文件。
```
<TypeScriptNoEmitOnError>true</TypeScriptNoEmitOnError>
```
AllowJs
是否允许编译器编译 .js 文件。
```
<TypeScriptAllowJs>true</TypeScriptAllowJs>
```

在 MSBuild 项目中配置 TypeScript 编译器选项

在 MSBuild 项目文件（例如 .csproj 文件）中，可以通过 <PropertyGroup> 和 <TypeScript> 元素来配置 TypeScript 编译器选项。以下是一个示例：

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>netcoreapp3.1</TargetFramework>
    <TypeScriptCompileBlocked>true</TypeScriptCompileBlocked>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.TypeScript.MSBuild" Version="4.3.5" />
  </ItemGroup>

  <PropertyGroup>
    <!-- TypeScript 编译器选项 -->
    <TypeScriptOutDir>wwwroot/js</TypeScriptOutDir>
    <TypeScriptSourceMap>true</TypeScriptSourceMap>
    <TypeScriptModuleResolution>node</TypeScriptModuleResolution>
    <TypeScriptTarget>ES5</TypeScriptTarget>
    <TypeScriptNoEmitOnError>true</TypeScriptNoEmitOnError>
    <TypeScriptAllowJs>true</TypeScriptAllowJs>
  </PropertyGroup>

</Project>

在这个例子中：

<TypeScriptOutDir> 指定了编译后 JavaScript 文件的输出目录。
<TypeScriptSourceMap> 设置为 true，生成对应的 source map 文件。
<TypeScriptModuleResolution> 设置为 node，使用 Node.js 模块解析策略。
<TypeScriptTarget> 指定了编译的目标 ECMAScript 版本为 ES5。
<TypeScriptNoEmitOnError> 设置为 true，在 TypeScript 编译错误时停止生成 JavaScript 文件。
<TypeScriptAllowJs> 设置为 true，允许编译器编译 .js 文件。

通过在 MSBuild 项目文件中配置这些选项，可以有效地控制 TypeScript 的编译行为，以适应项目的需求和环境。

参考

https://www.typescriptlang.org/docs/handbook/compiler-options-in-msbuild.html#handbook-content