@@ -9,23 +9,22 @@ translatable: true
99在一般的代码中,TypeScript 中的类型系统的严格程度是不一样的:
1010
1111- 只基于 JavaScript 代码推断
12- - 增强的 JavaScript 类型推断([ 通过 JSDoc] ( /zh/docs/handbook/jsdoc-supported-types.html ) )
12+ - 增强的 JavaScript 类型推断([ 通过 JSDoc] ( /zh/docs/handbook/jsdoc-supported-types.html ) )
1313- 在 JavaScript 文件里面使用 ` // @ts-check `
1414- TypeScript 代码
15- - TypeScript 的 [ ` strict ` ] ( /tsconfig#strict ) 模式
15+ - TypeScript 的 [ ` strict ` ] ( /zh/ tsconfig#strict ) 模式
1616
1717每一步都代表着向更安全的类型系统迈进,但并不是每个项目都需要级别最高的验证。
1818
1919## TypeScript 与 JavaScript
2020
21- 在使用某些编辑器时,它可以为使用 TypeScript 提供工具,如自动补全,跳转到特定位置。还有一些重构工具,如重命名。
22- [ 主页] ( / ) 有一个包含 TypeScript 插件的编辑器列表。
21+ 某些编辑器会使用 TypeScript 来提供帮助,如自动补全,跳转到特定位置。此外还可以帮助重构,如重命名。[ 主页] ( /zh ) 有一个编辑器列表,该列表中的编辑器包含 TypeScript 插件。
2322
2423## 通过 JSDoc 在 JS 中提供类型提示
2524
2625在 ` .js ` 文件里,类型通常可以被推断出来。当无法推断类型时,可以使用 JSDoc 语法来指定。
2726
28- 声明之前的 JSDoc 注释,将用于设置该声明的类型。例如:
27+ 位于声明语句之前的 JSDoc 注释,将用于设置该声明的类型。例如:
2928
3029``` js twoslash
3130/** @type {number} */
@@ -35,12 +34,11 @@ x = 0; // OK
3534x = false ; // OK?!
3635```
3736
38- 你可以 [ 在 JSDoc 支持的类型列表] ( /zh/docs/handbook/jsdoc-supported-types.html ) 找到支持的 JSDoc 模式的完整说明 。
37+ 你可以在 [ JSDoc 支持的类型列表] ( /zh/docs/handbook/jsdoc-supported-types.html ) 找到受支持的 JSDoc 语法的完整说明 。
3938
4039## ` @ts-check `
4140
42- 上述代码示例的最后一行会在 TypeScript 中引发错误,但在 JS 项目中,默认情况下不会引发错误。
43- 要在 JavaScript 文件显示错误,请在 ` .js ` 文件的第一行中添加: ` // @ts-check ` 。
41+ 上述代码示例的最后一行在 TypeScript 中会引发错误,但在 JS 项目中,默认情况下不会引发错误。要使 JavaScript 文件显示错误,请在 ` .js ` 文件的第一行中添加: ` // @ts-check ` 。
4442
4543``` js twoslash
4644// @ts-check
@@ -52,10 +50,9 @@ x = 0; // OK
5250x = false ; // Not OK
5351```
5452
55- 如果你有许多 JavaScript 文件要显示错误,则可以使用 [ ` jsconfig.json ` ] ( /zh/docs/handbook/tsconfig-json.html ) 来代替注释。
56- 你可以通过在文件中添加` // @ts-nocheck ` 注释来跳过检查某些文件。
53+ 如果你有许多 JavaScript 文件要显示错误,则可以使用 [ ` jsconfig.json ` ] ( /zh/docs/handbook/tsconfig-json.html ) 来代替注释。你可以通过在文件中添加 ` // @ts-nocheck ` 注释来跳过检查某些文件。
5754
58- TypeScript 可能会提供你不想看到的错误 ,在这种情况下,你可以通过在前一行添加 ` // @ts-ignore ` 或 ` // @ts-expect-error ` 来忽略某一行上的错误 。
55+ TypeScript 可能会提供一些你不想看到的错误 ,在这种情况下,你可以通过在某一行的前一行添加 ` // @ts-ignore ` 或 ` // @ts-expect-error ` 来忽略该行上的错误 。
5956
6057``` js twoslash
6158// @ts-check
@@ -67,4 +64,4 @@ x = 0; // OK
6764x = false ; // Not OK
6865```
6966
70- 要了解有关 TypeScript 如何解释 JavaScript 的更多信息 ,请阅读 [ TS 是如何解释 JS 的] ( /zh/docs/handbook/type-checking-javascript-files.html ) 。
67+ 要详细了解 TypeScript 如何解释 JavaScript,请阅读 [ TS 是如何检查 JS 的] ( /zh/docs/handbook/type-checking-javascript-files.html ) 。
0 commit comments