diff --git a/packages/tsconfig-reference/copy/zh/categories/Additional_Checks_6176.md b/packages/tsconfig-reference/copy/zh/categories/Additional_Checks_6176.md new file mode 100644 index 000000000000..3ff8dca93577 --- /dev/null +++ b/packages/tsconfig-reference/copy/zh/categories/Additional_Checks_6176.md @@ -0,0 +1,5 @@ +--- +display: "额外检查" +--- + +额外检查的集合,在某种程度上介于编译器与静态分析工具之间。如果想寻找更深入的规则,您可能更喜欢使用 ESLint 这样的工具。 diff --git a/packages/tsconfig-reference/copy/zh/categories/Advanced_Options_6178.md b/packages/tsconfig-reference/copy/zh/categories/Advanced_Options_6178.md new file mode 100644 index 000000000000..040a9ac3b919 --- /dev/null +++ b/packages/tsconfig-reference/copy/zh/categories/Advanced_Options_6178.md @@ -0,0 +1,5 @@ +--- +display: "高级" +--- + +调试相关的选项。 diff --git a/packages/tsconfig-reference/copy/zh/categories/Basic_Options_6172.md b/packages/tsconfig-reference/copy/zh/categories/Basic_Options_6172.md index 798129a1b745..2989e24ffa3a 100644 --- a/packages/tsconfig-reference/copy/zh/categories/Basic_Options_6172.md +++ b/packages/tsconfig-reference/copy/zh/categories/Basic_Options_6172.md @@ -1,5 +1,5 @@ --- -display: "工程选项" +display: "项目选项" --- -这些设置将用于指定你的工程的运行时配置,你希望 JavaScript 怎样被生成和生成在哪里,以及你希望与现有 JavaScript 代码的集成程度。 +这些设置用于定义项目的运行时期望、JavaScript 的输出方式和位置,以及与现有 JavaScript 代码的集成级别。 \ No newline at end of file diff --git a/packages/tsconfig-reference/copy/zh/categories/Command_line_Options_6171.md b/packages/tsconfig-reference/copy/zh/categories/Command_line_Options_6171.md new file mode 100644 index 000000000000..0713444ad8df --- /dev/null +++ b/packages/tsconfig-reference/copy/zh/categories/Command_line_Options_6171.md @@ -0,0 +1,3 @@ +--- +display: "命令行参数" +--- diff --git a/packages/tsconfig-reference/copy/zh/categories/Experimental_Options_6177.md b/packages/tsconfig-reference/copy/zh/categories/Experimental_Options_6177.md new file mode 100644 index 000000000000..67a677a22cbb --- /dev/null +++ b/packages/tsconfig-reference/copy/zh/categories/Experimental_Options_6177.md @@ -0,0 +1,7 @@ +--- +display: "实验选项" +--- + +TypeScript 力求只包含那些确认会被添加到 JavaScript 语言的特性。 + +不过某些情况下,一个特性被认为可以成为上述原则的例外。这些特性会以实验性的编译器选项存在。这些特性被添加到 JavaScript 语言的版本可能会有所不同,因此使用这些选项是有风险的。 diff --git a/packages/tsconfig-reference/copy/zh/categories/Project_Files_0.md b/packages/tsconfig-reference/copy/zh/categories/Project_Files_0.md new file mode 100644 index 000000000000..b47ce4dcb3eb --- /dev/null +++ b/packages/tsconfig-reference/copy/zh/categories/Project_Files_0.md @@ -0,0 +1,6 @@ +--- +display: "文件包含" +--- + +这些设置用于确保 TypeScript 处理正确的文件。 + diff --git a/packages/tsconfig-reference/copy/zh/categories/Source_Map_Options_6175.md b/packages/tsconfig-reference/copy/zh/categories/Source_Map_Options_6175.md new file mode 100644 index 000000000000..04ff8a3156f7 --- /dev/null +++ b/packages/tsconfig-reference/copy/zh/categories/Source_Map_Options_6175.md @@ -0,0 +1,7 @@ +--- +display: "Source Maps" +--- + +为了支持丰富的调试工具,并为开发人员提供有意义的崩溃报告,TypeScript 支持生成符合 JavaScript Source Map 标准的附加文件。 + +它们与对应的 JavaScript 文件一起生成,以 `.map` 结尾。 \ No newline at end of file diff --git a/packages/tsconfig-reference/copy/zh/categories/Strict_Type_Checking_Options_6173.md b/packages/tsconfig-reference/copy/zh/categories/Strict_Type_Checking_Options_6173.md new file mode 100644 index 000000000000..953c3a1b5385 --- /dev/null +++ b/packages/tsconfig-reference/copy/zh/categories/Strict_Type_Checking_Options_6173.md @@ -0,0 +1,15 @@ +--- +display: "严格模式" +--- + +我们推荐使用[编译器选项`strict`](#strict)来启用每个可能的改进。 + +TypeScript支持大量的 JavaScript 模式,默认选项允许相当大的灵活性来适应这些模式。 +然而,很多时候这些技巧的使用与保证代码的安全性和可扩展性的目标相冲突。 + +由于 TS 支持各种类型的 JavaScript,升级到新版本的 TypeScript 时可能出现两种新错误:: + +-代码中已存在的错误:因为语言已经改进了对 JavaScript 的理解,TypeScript 发现了它。 +-处理新一块问题的一套新错误。 + +TypeScript 通常会为后一类错误添加一个编译器选项,默认情况下这些选项是不启用的。 \ No newline at end of file diff --git a/packages/tsconfig-reference/copy/zh/categories/Watch_Options_999.md b/packages/tsconfig-reference/copy/zh/categories/Watch_Options_999.md new file mode 100644 index 000000000000..b61055c50e37 --- /dev/null +++ b/packages/tsconfig-reference/copy/zh/categories/Watch_Options_999.md @@ -0,0 +1,9 @@ +--- +display: "监听选项" +--- + +TypeScript 3.8 提供了一个监听目录的新策略,这对于有效地获取 `node_modules` 的更改至关重要。 + +在 Linux 这一类操作系统上,TypeScript 会在 `node_modules` 及其子目录上启动目录监听(而不是文件监听),以检测依赖关系的变化。这是因为 `node_modules` 中的文件数目巨大,经常超过系统允许的最大文件监听数量,而需要监听的目录却少得多。 + +由于不同项目的环境和需求等不同,这个新方法可能不适合你的工作流,因此 TypeScript 3.8 引入了一个新的 `watchOptions` 字段,允许用户告诉编译器或语言服务应该采用哪种策略来跟踪文件和目录更改。 diff --git a/packages/tsconfig-reference/copy/zh/intro.md b/packages/tsconfig-reference/copy/zh/intro.md new file mode 100644 index 000000000000..f21815a63f1c --- /dev/null +++ b/packages/tsconfig-reference/copy/zh/intro.md @@ -0,0 +1,6 @@ +## TSConfig 前言 + +目录中的 TSConfig 文件表明该目录是 TypeScript 或 JavaScript 项目的根目录。 +TSConfig 文件可以是 `tsconfig.json` 或 `jsconfig.json`,它们的配置项和行为相同。 + +此页涵盖了 TSConfig 文件中可用的所有不同选项。本页从每个选项的概述开始,到 JSON 文件的根属性,然后是`compilerOptions`(大部分选项),最后是 `watchOptions`。 diff --git a/packages/tsconfig-reference/copy/zh/sections/compilerOptions.md b/packages/tsconfig-reference/copy/zh/sections/compilerOptions.md new file mode 100644 index 000000000000..b473c5d339fa --- /dev/null +++ b/packages/tsconfig-reference/copy/zh/sections/compilerOptions.md @@ -0,0 +1,3 @@ +### 编译选项 + +这些选项是 TypeScript 配置的主要部分,它涵盖了语言应该如何工作。 diff --git a/packages/tsconfig-reference/copy/zh/sections/top_level.md b/packages/tsconfig-reference/copy/zh/sections/top_level.md new file mode 100644 index 000000000000..eb649831b38a --- /dev/null +++ b/packages/tsconfig-reference/copy/zh/sections/top_level.md @@ -0,0 +1,3 @@ +### 上层选项 + +首先是 TSConfig 中的顶层选项——这些选项与 TypeScript 或 JavaScript 项目的设置方式有关。