tsconfig

tsconfig

项目中 tsconfig.json 的 绝大多数 编译选项并不影响 Cocos Creator 对 TypeScript 的编译。因此，你需要小心配置其中的某些选项，以使得 IDE 的检查功能和 Cocos Creator 的编译行为一致。

以下选项不应当显式修改：

compilerOptions.target
compilerOptions.module

例如，若将 tsconfig.json 设置为：

{
    "compilerOptions": {
        "target": "es5",
        "module": "cjs"
    }
}

那么以下脚本代码在（使用 tsc 作为检查器的）IDE 中不会引起错误，因为 compilerOptions.module 设置为了 cjs。

const myModule = require("path-to-module");

然而 Cocos Creator 隐含的 compilerOptions.module 是 es2015，因此在运行时可能会提示 “require 未定义” 等错误。

以下脚本代码对于 Cocos Creator 来说是合法的，但 IDE 可能会报告错误。因为 compilerOptions.target 设置为了 es5，而 Set 是 ES6 才引入的。

const mySet = new Set();

对于其他选项，你可以自由修改。

例如，当你希望禁止你项目中所有 TypeScript 脚本对隐式 any 的使用，就可以在 tsconfig.json 中将 compilerOptions.noImplicitAny 设为 true。如此当你用 Visual Studio Code 等 IDE 检查该文件时就会收到相应的错误提示。

对于大多数项目而言，tsconfig.json 的某些选项是固定的。例如 compilerOptions.target、compilerOptions.module 以及 Cocos Creator 的类型声明文件位置等。

由于 tsc 的良好设计，extends 选项使得 tsconfig.json 可以是级联的。Cocos Creator 意识到了这一点，因此固定的 tsconfig 选项被放置在 {项目路径}/tmp/tsconfig.cocos.json 下，并由 Cocos Creator 管理。

于是，项目根路径下的 tsconfig 可以如下配置以共享这些固定选项：

{
    extends: './tmp/tsconfig.cocos.json',
    compilerOptions: {
        /* 自定义的 tsconfig 选项 */
    }
}

所幸，当你创建新项目时，Creator 将会自动生成这样的 tsconfig。

tsconfig 配置

tsconfig