Skip to content

docs: translate zh-cn for tsconfig-reference/intro & cat #1327

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Jan 21, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
display: "额外检查"
---

额外检查的集合,在某种程度上介于编译器与静态分析工具之间。如果想寻找更深入的规则,您可能更喜欢使用 <a href="https://github.com/typescript-eslint/typescript-eslint ">ESLint</a> 这样的工具。
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
display: "高级"
---

调试相关的选项。
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
display: "工程选项"
display: "项目选项"
---

这些设置将用于指定你的工程的运行时配置,你希望 JavaScript 怎样被生成和生成在哪里,以及你希望与现有 JavaScript 代码的集成程度
这些设置用于定义项目的运行时期望、JavaScript 的输出方式和位置,以及与现有 JavaScript 代码的集成级别
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
display: "命令行参数"
---
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
display: "实验选项"
---

TypeScript 力求只包含那些确认会被添加到 JavaScript 语言的特性。

不过某些情况下,一个特性被认为可以成为上述原则的例外。这些特性会以实验性的编译器选项存在。这些特性被添加到 JavaScript 语言的版本可能会有所不同,因此使用这些选项是有风险的。
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
display: "文件包含"
---

这些设置用于确保 TypeScript 处理正确的文件。

Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
display: "Source Maps"
---

为了支持丰富的调试工具,并为开发人员提供有意义的崩溃报告,TypeScript 支持生成符合 JavaScript Source Map 标准的附加文件。

它们与对应的 JavaScript 文件一起生成,以 `.map` 结尾。
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
display: "严格模式"
---

我们推荐使用[编译器选项`strict`](#strict)来启用每个可能的改进。

TypeScript支持大量的 JavaScript 模式,默认选项允许相当大的灵活性来适应这些模式。
然而,很多时候这些技巧的使用与保证代码的安全性和可扩展性的目标相冲突。

由于 TS 支持各种类型的 JavaScript,升级到新版本的 TypeScript 时可能出现两种新错误::

-代码中已存在的错误:因为语言已经改进了对 JavaScript 的理解,TypeScript 发现了它。
-处理新一块问题的一套新错误。

TypeScript 通常会为后一类错误添加一个编译器选项,默认情况下这些选项是不启用的。
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
display: "监听选项"
---

TypeScript 3.8 提供了一个监听目录的新策略,这对于有效地获取 `node_modules` 的更改至关重要。

在 Linux 这一类操作系统上,TypeScript 会在 `node_modules` 及其子目录上启动目录监听(而不是文件监听),以检测依赖关系的变化。这是因为 `node_modules` 中的文件数目巨大,经常超过系统允许的最大文件监听数量,而需要监听的目录却少得多。

由于不同项目的环境和需求等不同,这个新方法可能不适合你的工作流,因此 TypeScript 3.8 引入了一个新的 `watchOptions` 字段,允许用户告诉编译器或语言服务应该采用哪种策略来跟踪文件和目录更改。
6 changes: 6 additions & 0 deletions packages/tsconfig-reference/copy/zh/intro.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
## TSConfig 前言

目录中的 TSConfig 文件表明该目录是 TypeScript 或 JavaScript 项目的根目录。
TSConfig 文件可以是 `tsconfig.json` 或 `jsconfig.json`,它们的配置项和行为相同。

此页涵盖了 TSConfig 文件中可用的所有不同选项。本页从每个选项的概述开始,到 JSON 文件的根属性,然后是`compilerOptions`(大部分选项),最后是 `watchOptions`。
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
### 编译选项

这些选项是 TypeScript 配置的主要部分,它涵盖了语言应该如何工作。
3 changes: 3 additions & 0 deletions packages/tsconfig-reference/copy/zh/sections/top_level.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
### 上层选项

首先是 TSConfig 中的顶层选项——这些选项与 TypeScript 或 JavaScript 项目的设置方式有关。