TypeScript 是由微软开发的一种能用来编译出 JavaScript 代码的编程语言,因其比 JavaScript 编程语言还多了一道编译手续,能够在编译阶段找出代码语法上的问题,而且也添加了类型检查机制,让程序更容易阅读与调试,使得 TypeScript 更适合用来开发大型项目。TypeScript 兼容于 JavaScript,白话一点来说就是 JavaScript 代码也可以通过 TypeScript 编译器的编译,而且还能够实现 JavaScript 的版本转换(例如 ES6 转 ES5)。

TypeScript 官方网站:

在此先提醒一下,这个系列的文章并不会介绍程序开发的基本逻辑概念(如变量、循环等定义),因此可能比较不适合完全不懂编程语言的人参考,不过还是会从头介绍 TypeScript 的语法和用法,让不会 JavaScript 的开发者也能够看得懂。

安装与设置 TypeScript 开发环境

Node.js

为了要开发 TypeScript 程序,我们需要先设置好 Node.js 和 npm 环境,建议使用 Node.js 最新的 LTS 版本。

Node.js 是 JavaScript 程序的运行环境,可以让我们不必打开网页浏览器也可以运行 JavaScript 程序。而 npm 则是 JavaScript 的套件管理器,常会与 Node.js 一同被安装。

Windows 的用户可以直接到 Node.js 官方网站下载到 Node.js 的安装档,而 Linux 操作系统或是 macOS 的用户可以参考这篇文章来安装指定版本的 Node.js。

tsc

tsc 是 TypeScript 程序的编译器,能够将 TypeScript 代码编译为 JavaScript 程序。

运行以下 npm 指令,即可安装 tsc 指令工具:

npm i -g typescript

Hello World

安装与设置完 TypeScript 开发环境之后,就可以开始撰写 TypeScript 程序啦!依照惯例,我们来写写看在学习编程语言时总会写的第一支程序──「Hello World」。「Hello World」是一支非常简单的小程序,运行这支程序之后,屏幕上就会印出 Hello, world! 这几个字。

创建项目目录

大部分的情况下,在开始撰写 TypeScript 程序时,会使用 npm 来创建出 Node.js 项目,但由于「Hello World」是我们第一支的程序,我们倾向用最单纯的方式完成它,所以在此先不使用 npm。

首先,创建一个用来存放 TypeScript 项目的目录 hello-world。

创建 TypeScript 源代码文件

接着在项目目录中创建一个纯文字文件,文件名取为 index.ts。虽然这边的文件名称使用 index.ts 之外的其它名称也是可以,但我们在之后用 Node.js 项目来开发 TypeScript 程序时,主要会以 index.ts 作为程序进入点,所以还是先习惯一下这个名称比较好。

接着使用文字编辑器打开刚才创建的 index.ts,并输入以下代码:

console.log("Hello, world!");

存盘之后,先别急着用 tsc 编译,我们可以直接使用 Node.js 提供的 node 指令,来尝试运行它。指令如下:

node index.ts

以 node 运行 Hello World 的 index.ts

从上图中可以发现,node index.ts 指令有被成功运行,而且也成功在屏幕上印出 Hello, world! 这几个字了!

这是因为我们目前写的程序,只是 JavaScript 的部份,所以 Node.js 可以直接运行。

hello 函数

如果只在 TypeScript 写 JavaScript,那用 TypeScript 还有什么意思?我们来将以上 index.ts 文件的代码改成以下这样吧!

function hello (target: string): void {                                                           
    console.log(`Hello, ${target}!`);
}
 
hello("world");

同样地,在存盘之后先别急着用 tsc 编译,我们可以直接使用 Node.js 提供的 node 指令,来尝试运行它。指令如下:

node index.ts

node 运行含类型的 index.ts 失败

这次的 node index.ts 指令就运行失败了,因为 Node.js 并无法支持 TypeScript 自创的语法。所以我们要用 tsc 先编译 index.ts,指令如下:

tsc index.ts

以 tsc 编译 index.ts

以上指令会编译 index.ts 文件,并将结果输出成 index.js 文件。这个 index.js 文件的内容如下:

function hello(target) {
    console.log("Hello, ".concat(target, "!"));
}
hello("world");

接着用 Node.js 运行 index.js 文件试试。指令如下:

node index.js

以 node 运行编译出的 index.js

如上图,成功在屏幕上印出 Hello, world! 这几个字了!

Hello World 代码解析

我们来看以下刚才写的(或是拷贝粘贴的)TypeScript 程序究竟是在做什么。先看一下代码的第 1 行和第 3 行:

function hello (target: string): void {                                                           
    console.log(`Hello, ${target}!`);
}
 
hello("world");

这样的结构定义了一个名叫 hello 的函数,并在名称后面又使用了冒号 : 来连接了一个类型名称,来限制这个函数的回传值类型,void 这个类型名称表示没有回传值。如果函数名称后面不加上冒号 : 的话,这个函数回传的类型就会由 tsc 根据函数的实作方式来推论,这部份会在之后的章节详细介绍。

第 1 行在左大括号 { 之前我们定义了这个函数的签名(signature),小括号 () 内则是定义函数的参数,在此有一个名叫 target 的参数,且这个参数因为名称后面又使用了冒号 : 来连接了一个类型名称,所以这个 target 参数的类型必须要是 string,也就是一个字符串。换句话说,如果参数名称后面不加上冒号 : 的话,这个参数就可以是任意类型(任意类型的类型名称为 any,刚才提到的 void 也是属于 any)。

接着来说明一下大括号 {} 的意义。这组紧接在函数签名之后的大括号,定义了该函数的主体(body),也就是该函数被调用的时候要运行的叙述(statement)。

function hello (target: string): void {                                                           
    console.log(`Hello, ${target}!`);
}
 
hello("world");

程序第 2 行,使用了 console 这个 JavaScript 运行环境自带的对象,可以用来访问主控台,其提供的 log 方法可以在主控台上印出从参数传入的任意类型的值。借由小数点 .,我们可以访问某个值的属性(property),console.log 即表示要访问 console 这个对象下的 log 属性,而 log 属性所保存的值是一个可以传入任意数量的任意值作为参数的函数。

此处传进 log 函数的第一个参数的值为一个字符串,用 ` 字符包了起来,并在其中以 ${} 这样的语法置入 target 参数的内容。这个 `${}` 语法是在 ES6 时被加入的,称作「模板定数」(Template Literals),能让我们直接在 ${} 的大括号中填入 JavaScript 的表达式。至于分号,TypeScript 的代码叙述的结尾分号写不写都可以,端看开发者的代码风格。

function hello (target: string): void {                                                           
    console.log(`Hello, ${target}!`);
}
 
hello("world");

程序第 5 行,调用了 hello 函数,并在第一个参数传入 world 字符串。此处的字符串使用了 JavaScript 基本的字符串语法,也就是用两个单引号 ' 或是双引号 " 来将文字包装起来,形成字符串定数(literal)。顺带一提,JavaScript 基本的字符串语法无法直接换行,需要用 \ 字符来跳脱才可以,但是「模板定数」是可以直接换行的。

如果我们像以下这样将第 5 行的字符串改为整数数值的话:

function hello (target: string): void {                                                           
    console.log(`Hello, ${target}!`);
}
 
hello(123);

则第 5 行会编译失败,因为 TypeScript 限制了 target 参数必须要是一个字符串。

传入数字参数时的编译错误

tsc 编译的目标(Target)

眼尖的人应该会发现,方才的「Hello World」程序 index.ts 文件中的 `Hello, ${target}!`,在被 tsc 编译之后,会变成 "Hello, ".concat(target, "!")。这是因为 tsc 会主动将新版的 JavaScript 语法转为旧版的(ES3),以求最大的程序兼容性。如果我们将 `Hello, ${target}!` 改成旧版 JavaScript 使用 + 操作符来连接字符串的作法,也就是改成 'Hello, ' + target + '!',然后再进行编译,依然会得到 'Hello, ' + target + '!'。

当然,我们是可以控制 tsc 所输出的 JavaScript 版本的。只要加上 -t 或是 --target 参数,再接上版本名称就可以了。例如要编译 index.ts 文件并将其输出成 ES6 的版本,指令如下:

tsc index.ts -t ES6

此时编译出来的 index.js 文件内容如下:

function hello(target) {
    console.log(`Hello, ${target}!`);
}              
hello("world");

有关于 JavaScript 版本的功能差异,可以参考这个网页。有关于 TypeScript 支持输出的 JavaScript 版本有哪些,之后的章节有用到时会再顺便提及。

总结

在这一章中,我们设置好 TypeScript 的开发环境,学会了如何用 TypeScript 的编译器,也就是 tsc 来将 TypeScript 代码编译为 JavaScript 程序。

在下一章节中,我们将会实际写一个简单的小程序,来学习 TypeScript 编程语言的基本概念和语法!

下一章:用 TypeScript 写个猜数字程序吧!