Translate 1 file to zh - tsconfig.json

Author: originalix

docs/documentation/zh/project-config/tsconfig.json.md

@@ -0,0 +1,116 @@
+---
+title: tsconfig.json 是什么
+layout: docs
+permalink: /zh/docs/handbook/tsconfig-json.html
+oneline: 了解 TSConfig 的工作原理
+translatable: true
+---
+
+## 概览
+
+当目录中出现了 `tsconfig.json` 文件，说明该目录是 Typescript 项目的根目录。`tsconfig.json` 文件指定了编译项目所需的根目录下的文件以及编译选项。
+
+JavaScript 项目可以使用 `jsconfig.json` 文件代替，它的作用与 `tsconfig.json` 基本相同，只是默认启用了一些 JavaScript 相关的编译选项。
+
+一个项目将以下列之一的方式编译:
+
+## 使用 `tsconfig.json` 或者 `jsconfig.json`
+
+- 调用 tsc 命令并且没有其它输入文件参数时，在这种情况下编译器会搜索 `tsconfig.json` 文件，从当前目录开始搜索，一直搜寻到父级目录。
+
+- 调用 tsc 命令并且没有其他输入文件参数，使用 `--project` （或者只是 `-p`）的命令行选项来指定包含了 `tsconfig.json` 的目录，或者包含有效配置的 `.json` 文件路径。
+
+当命令行中指定了输入文件参数， `tsconfig.json` 文件会被忽略。
+
+## 示例
+
+`tsconfig.json` 文件示例：
+
+- 使用 `files` 属性
+
+  ```json tsconfig
+  {
+    "compilerOptions": {
+      "module": "commonjs",
+      "noImplicitAny": true,
+      "removeComments": true,
+      "preserveConstEnums": true,
+      "sourceMap": true
+    },
+    "files": [
+      "core.ts",
+      "sys.ts",
+      "types.ts",
+      "scanner.ts",
+      "parser.ts",
+      "utilities.ts",
+      "binder.ts",
+      "checker.ts",
+      "emitter.ts",
+      "program.ts",
+      "commandLineParser.ts",
+      "tsc.ts",
+      "diagnosticInformationMap.generated.ts"
+    ]
+  }
+  ```
+
+- 使用 `"include"` 和 `"exclude"` 属性
+
+  ```json  tsconfig
+  {
+    "compilerOptions": {
+      "module": "system",
+      "noImplicitAny": true,
+      "removeComments": true,
+      "preserveConstEnums": true,
+      "outFile": "../../built/local/tsc.js",
+      "sourceMap": true
+    },
+    "include": ["src/**/*"],
+    "exclude": ["node_modules", "**/*.spec.ts"]
+  }
+  ```
+
+## TSConfig 基础
+
+根据你想要执行代码的 JavaScript 运行时环境，可能有一个基本配置，你可以参考[github.com/tsconfig/bases](https://github.com/tsconfig/bases/)来使用。
+这些你的项目扩展的 `tsconfig.json` 文件，它通过运行时的支持来简化你的 `tsconfig.json` 文件配置。
+
+<!-- 这些是你的项目扩展的""文件，它通过处理运行时支持简化你的“” -->
+举个例子，如果你的项目是基于 Node.js 12.x 写的，那么你可以使用 npm 依赖：[`@tsconfig/node12`](https://www.npmjs.com/package/@tsconfig/node12):
+
+```json tsconfig
+{
+  "extends": "@tsconfig/node12/tsconfig.json",
+
+  "compilerOptions": {
+    "preserveConstEnums": true
+  },
+
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "**/*.spec.ts"]
+}
+```
+
+这使你的 `tsconfig.json` 专注在你自己选择的项目环境上，而不是所有的运行时环境。现在已经有了一些 tsconfig 基础配置，我们希望社区能够为不同的环境添加更多的内容。
+
+- [推荐配置](https://www.npmjs.com/package/@tsconfig/recommended)
+- [Node 10](https://www.npmjs.com/package/@tsconfig/node10)
+- [Node 12](https://www.npmjs.com/package/@tsconfig/node12)
+- [Node 14](https://www.npmjs.com/package/@tsconfig/node14)
+- [Deno](https://www.npmjs.com/package/@tsconfig/deno)
+- [React Native](https://www.npmjs.com/package/@tsconfig/react-native)
+- [Svelte](https://www.npmjs.com/package/@tsconfig/svelte)
+
+## 细节
+
+当`"compilerOptions"` 属性忽略的时候，会使用编译器的默认配置。请参考我们支持的[编译器选项](/tsconfig)列表
+
+## TSConfig 参考
+
+想要了解更多的配置选项的信息，请访问 [TSConfig Reference](/tsconfig)
+
+## 模式
+
+`tsconfig.json` 的模式可以在这里找到 [the JSON Schema Store](http://json.schemastore.org/tsconfig).