zhongsp / typescript

TypeScript 使用手册（中文版）翻译。http://www.typescriptlang.org

TypeScript

上新！

之前有许多小伙伴提出希望能将该手册发布为Book， 近来该项目又持续不断地有新的朋友关注， 因此现将所有文档整理发布为图书样式。希望大家能够喜欢!

线上阅读地址：https://zhongsp.github.io/TypeScript

---

TypeScript 5.4 (2024 年 3 月 6 日) | 版本发布说明

✔️ TypeScript 语言用于大规模应用的 JavaScript 开发。 ✔️ TypeScript 支持类型，是 JavaScript 的超集且可以编译成纯 JavaScript 代码。 ✔️ TypeScript 兼容所有浏览器，所有宿主环境，所有操作系统。 ✔️ TypeScript 是开源的。

🆕🆕🆕

ISBN 9787111669722

各位朋友们，本人近期出版了《TypeScript 入门与实战》一书。在该书中，尝试着尽可能完整地介绍 TypeScript 语言的基础知识，并结合了一些本人的使用经验和体会。它主要面向的是 TypeScript 语言的初级和中级使用者。

本人还处于 TypeScript 语言的学习阶段，可能存在理解错误的地方，还请大家指正，一起进步。此外，由于这是本人人生中出版的第一本书，难免会有纰漏，请大家多多包涵！

如果觉得不错可以微信打赏哟 <3

目录

• 快速上手
  • 5 分钟了解 TypeScript
  • ASP.NET Core
  • ASP.NET 4
  • Gulp
  • Knockout.js
  • React 与 webpack
  • React
  • Angular 2
  • 从 JavaScript 迁移到 TypeScript
• 手册
  • 基础类型
  • 接口
  • 函数
  • 字面量类型
  • 联合类型和交叉类型
  • 类
  • 枚举
  • 泛型
• 手册（进阶）
  • 高级类型
  • 实用工具类型
  • Decorators
  • 声明合并
  • Iterators 和 Generators
  • JSX
  • 混入
  • 模块
  • 模块解析
  • 命名空间
  • 命名空间和模块
  • Symbols
  • 三斜线指令
  • 类型兼容性
  • 类型推论
  • 变量声明
• 手册（v2）
  • 模版字面量类型
• 如何书写声明文件
  • 介绍
  • 举例
  • 库结构
  • 模板
  • 最佳实践
  • 深入
  • 发布
  • 使用
• JavaScript
  • JavaScript 文件里的类型检查
• 工程配置
  • tsconfig.json
  • 工程引用
  • NPM 包的类型
  • 编译选项
  • 配置 Watch
  • 在 MSBuild 里使用编译选项
  • 与其它构建工具整合
  • 使用 TypeScript 的每日构建版本
• Wiki
  • TypeScript 里的 this
  • 编码规范
  • 常见编译错误
  • 支持 TypeScript 的编辑器
  • 结合 ASP.NET v5 使用 TypeScript
  • 架构概述
  • 发展路线图
• 新增功能
  • TypeScript 5.4
  • TypeScript 5.3
  • TypeScript 5.2
  • TypeScript 5.1
  • TypeScript 5.0
  • TypeScript 4.9
  • TypeScript 4.8
  • TypeScript 4.7
  • TypeScript 4.6
  • TypeScript 4.5
  • TypeScript 4.4
  • TypeScript 4.3
  • TypeScript 4.2
  • TypeScript 4.1
  • TypeScript 4.0
  • TypeScript 3.9
  • TypeScript 3.8
  • TypeScript 3.7
  • TypeScript 3.6
  • TypeScript 3.5
  • TypeScript 3.4
  • TypeScript 3.3
  • TypeScript 3.2
  • TypeScript 3.1
  • TypeScript 3.0
  • TypeScript 2.9
  • TypeScript 2.8
  • TypeScript 2.7
  • TypeScript 2.6
  • TypeScript 2.5
  • TypeScript 2.4
  • TypeScript 2.3
  • TypeScript 2.2
  • TypeScript 2.1
  • TypeScript 2.0
  • TypeScript 1.8
  • TypeScript 1.7
  • TypeScript 1.6
  • TypeScript 1.5
  • TypeScript 1.4
  • TypeScript 1.3
  • TypeScript 1.1
• Breaking Changes
  • TypeScript 3.6
  • TypeScript 3.5
  • TypeScript 3.4
  • TypeScript 3.2
  • TypeScript 3.1
  • TypeScript 3.0
  • TypeScript 2.9
  • TypeScript 2.8
  • TypeScript 2.7
  • TypeScript 2.6
  • TypeScript 2.4
  • TypeScript 2.3
  • TypeScript 2.2
  • TypeScript 2.1
  • TypeScript 2.0
  • TypeScript 1.8
  • TypeScript 1.7
  • TypeScript 1.6
  • TypeScript 1.5
  • TypeScript 1.4

TypeScript 手册官方英文版

• TypeScript 手册（英文版）

TypeScript 语言规范

• TypeScript 语言规范

期待你为翻译做出贡献:)

typescript's Issues

Breaking Changes: TypeScript 1.6

https://github.com/Microsoft/TypeScript-wiki/blob/master/Breaking-Changes.md#typescript-16

Discuss a noun Translation

在类型兼容性一节，起始部分：
TypeScript里的类型兼容性基于结构子类型的。 结构类型是只一种只使用其成员来描述类型的方式。 它正好与名义类型形成对比。

改为如下是不是会更好一些？：

TypeScript里的类型兼容性 是 基于结构子类型的。 结构类型是 只 一种只使用其成员来描述类型的方式。 它正好与 具名 类型形成对比。

nominal 这个词计算机词典中解释为：标称，额定，指定

Add translation for "'Add a quick-start guide on React with webpack"

Source: https://github.com/Microsoft/TypeScript-Handbook/blob/master/pages/quick-start/react-webpack.md

「极客学院」电子书原创作者邀请

您好：我是极客学院 wiki 组的，2月底给您发过邮件，一直没有收到回复。

想和您沟通一下《TypeScript Handbook（中文版）》合作事情。

qq/微信/手机:[phone]

网址：wiki.jikexueyuan.com 可以了解一下

期待您的回复

Review & Sync "Module Resolution.md"

https://github.com/Microsoft/TypeScript-Handbook/blob/master/pages/Module%20Resolution.md

Add translation for "Add a quick-start guide on asp-net"

source:https://github.com/Microsoft/TypeScript-Handbook/blob/master/pages/quick-start/asp-net.md

Add translation for "TypeScript Editor Support"

Source: https://github.com/Microsoft/TypeScript/wiki/TypeScript-Editor-Support

Breaking Changes: TypeScript 1.5

https://github.com/Microsoft/TypeScript-wiki/blob/master/Breaking-Changes.md#typescript-15

Suggest index signatures for excess properties/update index signatures.

Source: https://github.com/Microsoft/TypeScript-Handbook/pull/211/files

New section "Migrating from JavaScript"

https://github.com/Microsoft/TypeScript-Handbook/blob/master/pages/tutorials/Migrating%20from%20JavaScript.md

求助：关于如何在github创立和管理一个外语文档的翻译项目

感谢所有贡献者的辛勤工作，提供了这么好的中文文档。
另外，我非常好奇如何管理这样一个共同翻译的项目。我只知道大致的github和gitbook用法。以下是我对于管理这样一个项目的想法和疑问，请给指点，谢谢。
如果是我来做，我可能会这么做：

1. 如果原项目的文档本身就在github上，我想我会先fork一份咯。（但是这里面对另外一种情况我不知道怎么办好，就是原文档没有在github上，或者说没有以git资源形式给出，如android官方的开发指南就没有托管在github，而是以网页的形式直接在他们的网站上发布。写爬虫抓取人家的网页回来改？）
   2、github上的文档应该都是MD写的，如果有原文件应该只要分配好每个人翻译的章节，然后各自翻译好之后PR回翻译项目应该就差不多了。

下面基本是疑问：

1. 如何跟进原文档的更新。最理想的情况是我们从原项目fork出项目原文件，翻译完成。但是之后原文档会更新，我们怎么跟进。我的意思如何能锁定原项目文档部分的更新，而其他如程序原代码的更改自动忽略。当官方文档有更新时我们及时修改自己的翻译。甚至于可以提示读者哪里更新了，让之前看过文档的人着重了解新东西。还有一种最坏的情况，就是原文档是网页我们如何跟进这种更新，人肉？
   2、MD格式的文档翻译好之后，在github上确认通过，如何及时更新到gitbook，或是我自己为读者设立的网站，让他们能看到最新的内容。有什么工具可以用还是有什么套路可寻。谢谢

麻烦解答尽可能接地气咯，不要说自己搜索一下就会了，搜索了很久还是找不到路，所以才请诸大神赐教。
你可以这样：
解决你的问题可以这样：1、XXXXXXXX2、XXXXXXXX3、XXXXXXXX……
或者
想觉得这些知识推荐你看看这些文章：URL1,URL2,URL3……
或者
有下面这些好用的工具可以用：工具1，工具2，工具3

指条明路我会自己往前走的，先谢过

Add translation for "Using TypeScript With ASP.NET 5"

Source: https://github.com/Microsoft/TypeScript/wiki/Using-TypeScript-With-ASP.NET-5

访问不了

TypeScript手册中文版 - Published with GitBook（持续更新中，最新版），目前访问不了。
https://zhongsp.gitbooks.io/doc/handbook/tutorials/index.html 快速上手页面 404

Add translation for "Add a quick-start guide on ASP.NET Core"

source: https://github.com/Microsoft/TypeScript-Handbook/blob/master/pages/quick-start/asp-net-core.md

Add translation for "Breaking Changes"

Source: https://github.com/Microsoft/TypeScript/wiki/Breaking-Changes

《接口》章节，示例代码里 是不是写错了!

if (config.color) {
// Error: Property 'collor' does not exist on type 'SquareConfig'

这个地方 if 里边应该是 config.collor 吧， 因为你是想给出一个错误的案例，结果 写的是正确的代码。

Breaking Changes: TypeScript 1.8

https://github.com/Microsoft/TypeScript-wiki/blob/master/Breaking-Changes.md#typescript-18

Advanced type: Discriminated Unions

Source: https://github.com/Microsoft/TypeScript-Handbook/blob/master/pages/Advanced%20Types.md#discriminated-unions

Breaking Changes: TypeScript 1.4

https://github.com/Microsoft/TypeScript-wiki/blob/master/Breaking-Changes.md#typescript-14

Add translation for "JSX"

Source: https://github.com/Microsoft/TypeScript-Handbook/blob/master/pages/JSX.md

Add translation for "Architectural Overview"

Source: https://github.com/Microsoft/TypeScript/wiki/Architectural-Overview

1.3 gulp

There will be errors "Error: Cannot find module 'typescript'", when I used the tsify. To slove it , run npm install typescript ;but in the first of this page ,it suggests to run 'npm install -g typescript gulp-cli'.

Lots of new articles and updates for TypeScript release 2.0

你授权的TypeScript中文网文档部分今天上线

你好，
之前你曾经授权给TypeScript中文网中文文档今天上线了。你是否要确认一下。

Add translation for "'Module Resolution"

Source: https://github.com/Microsoft/TypeScript-Handbook/blob/master/pages/Module%20Resolution.md

Document discriminated unions

https://github.com/Microsoft/TypeScript-Handbook/pull/330/files?diff=split

GitBook 上错误的语言设置

打开 https://zhongsp.gitbooks.io/typescript-handbook/content/index.html
html标签上写着 lang="zh-tw" ，但是显然文章是简体字写的，导致文章的所有字体都不正确。
看了看也不知道是哪里的问题……
总之可不可以处理一下这个问题，谢谢。

Add translation for "What's new in TypeScript"

Source: https://github.com/Microsoft/TypeScript/wiki/What's-new-in-TypeScript

Variable Declarations.md The last paragraph

The last paragraph of this document : Variable Declarations.md,I can not translate

Breaking Changes: TypeScript 2.0

https://github.com/Microsoft/TypeScript-wiki/blob/master/Breaking-Changes.md#typescript-20

1.3 gulp

There will be errors "Error: Cannot find module 'typescript'", when I used the tsify. To slove it , run npm install typescript ;but in the first of this page ,it suggests to run 'npm install -g typescript gulp-cli'.

能不能导出个PDF给下载，让人没有网的时候也能看看

感谢卓越的翻译工作。
现在家里宽带改造，很长一段时间上不了网，手机信号也不好，移动网络不稳定。如果有PDF版可以下载，就不用网也能看了。你觉得呢？

Add translation for "Common Errors"

Source: https://github.com/Microsoft/TypeScript/wiki/Common-Errors

New section "What's new in TypeScript 2.0"

https://github.com/Microsoft/TypeScript/wiki/What%27s-new-in-TypeScript

Add translation for "Add a quick-start guide on Knockout.js"

Source: https://github.com/Microsoft/TypeScript-Handbook/blob/master/pages/quick-start/knockout.md

New section "What's new in TypeScript 2.1"

https://github.com/Microsoft/TypeScript/wiki/What's-new-in-TypeScript#typescript-21

建议：将Angular官方文档链接到中文版

Angular 2官方文档的中文版已经部署在了https://angular.cn，并且Angular英文版的页脚中也链接到了此处，建议文中指向Angular的部分可以加注中文版地址。

Sync "Interfaces.md"

https://github.com/Microsoft/TypeScript-Handbook/blob/master/pages/Interfaces.md

Dts writing

https://github.com/Microsoft/TypeScript-Handbook/pull/335/files?diff=split

请问TypeScript中文手册是否可以授权给TypeScript中文网使用

你好，两个月前给你的Gmail邮箱发送过邮件，向你询问是否可以将你翻译的TypeScript中文手册授权TypeScript中文网使用事情，但你一直没有回复，在此向你询问是否可以将你翻译的TypeScript中文手册授权TypeScript中文网使用？
我的联系方式：邮箱[email protected]

ASP.NET 5 is dead - Introducing ASP.NET Core 1.0 and .NET Core 1.0

当我按照这个教程学习TypeScript的时候，

5.选择 ASP.NET 5 Empty 工程模板

到选择工程模板这块时问题来了
我已经安装过VS2015Update3了补丁也更新过了，死活是找不到aspnet5工程模板，
去网上搜索很多是让安装

Microsoft ASP.NET and Web Tools 2015

搜这个东西下载下来的是

DotNetCore.1.0.1-VS2015Tools.Preview2.0.2.exe

安装这个东西是各种失败啊，各种搜索无果后，想起来在学习PHP的时候搭建PHP环境时
需要安装vcredist_x64.exe（C++运行库），装了之后还是提示孩子啊找不到，装了个32位的
可以了，就想着是不是DotNetCore.1.0.1仅仅装了64位的不行啊，就下载32位的装了，可以了
上面Tools可以安装了，我疯了。
一切就绪准备继续TypeScript学习，依然找asp.net 5工程模板无果，怎么办？快哭了
结果就在google搜索asp.net 5，收到了SCOTT HANSELMAN这货的asp.net 5 is dead，骂了
半天微软，终于明白asp.net 5工程模板是找不到了，asp.net core webapplication的模板可以
继续用，最后看到熟悉的project.json我的内心是崩溃的，洪荒之力已经用完了，终于可以开始
学习TypeScript的了。
我太过纠结了，提个issue的目的是更新下知识库，技术迭代导致这手册难读也算是issue了，keep moving！

Add translation for "'this' in TypeScript"

Source: https://github.com/Microsoft/TypeScript-wiki/blob/master/'this'-in-TypeScript.md

感觉个别地方不太通顺

对TypeScript感兴趣了，找到了您的项目。
迫不急待地读了起来，感到您翻译地很好。
但我初学这个语言，感觉您在表述的个别地方不是很好理解，提一点点小小的意见。
再次感谢您的所做的翻译工作。

1、基础类型

在这里：任意值
但是Object类型的变量只是允许你给它赋任意值 -- 但是你不像在它上面调用任意方法，

2、变更声明

在这里：作用域规则
其中之一就是，多次声明一个变量被不会报错：

还有在这里：重定义及屏蔽
并不是说块级作用域变量不能在函数作用域内声明。 而是块级作用域变量需要在不用的块里声明。

还有在这里：块级作用域变量的获取
当我们最初谈起获取用var声明的变量时，我们主要是说获取后变量的行为是什么。

Add translation for "Roadmap"

Source: https://github.com/Microsoft/TypeScript/wiki/Roadmap

Breaking Changes: TypeScript 1.1

https://github.com/Microsoft/TypeScript-wiki/blob/master/Breaking-Changes.md#typescript-11

Sync "quick-start/react-webpack.md"

Lot's of differences. Need to sync.

Source: https://github.com/Microsoft/TypeScript-Handbook/blob/master/pages/quick-start/react-webpack.md

How typescript import a normal js?

Hi zhongsp,
Thanks for your document. It's really helpful for me to learn the ts. But something I didn't get from you document about how to import a online js into ts.

I want to use baidu map into my typescript. But the baidu map api is totally online. The URL is http://api.map.baidu.com/api?v=2.0&ak=test.

I can't download the baidu map api js into my project. And I can't find a way to import this Online js into my ts. Please give me some suggestion. Thanks so much.

howto:in d.ts declare same instance method and same instance variable has same name

e.g.

JS Class : Test
Instance Method : var number =test.size();
Instance Variable : size Type:Number

or
see: http://www.nodegit.org/api/diff_file/

thanks!

Breaking Changes: TypeScript 1.7

https://github.com/Microsoft/TypeScript-wiki/blob/master/Breaking-Changes.md#typescript-17

Review & Sync "Classes.md"

https://github.com/Microsoft/TypeScript-Handbook/blob/master/pages/Classes.md