TypeScript Node.js 怎么用

平时写Node.js的时候，是不是总被各种“坑”绊住？比如调用了一个不存在的函数，或者参数传错类型，要到运行后才报错调试半天？这时候试试TypeScript，它能帮你提前揪出这些问题，让Node.js项目更稳。

第一步：先搭好基础环境

要在Node.js里用TypeScript，先得装两个工具——Node.js和TypeScript。先装Node.js（去官网下稳定版就行，装完打开命令行，输node -v能看到版本号，说明装好了）；然后在命令行输npm install -g typescript，这是全局装TypeScript的编译器，相当于把“翻译器”装到电脑上，能把TypeScript转成Node.js能看懂的JavaScript。

第二步：初始化项目和配置文件

建个文件夹当项目，打开命令行进这个文件夹，输npm init -y，会生成个package.json，是项目的配置清单。然后还要个关键文件tsconfig.json，这是告诉TypeScript怎么转代码，输tsc --init就能自动生成。打开这个文件，改几个简单的配置：把"target"改成"ES6"（让转出来的代码兼容大多数Node.js版本），把"outDir"改成"./dist"（转好的代码放这个文件夹，别和源文件混），把"rootDir"改成"./src"（源文件都放src文件夹里，规整好），这样基础就搭好了。

第三步：写第一个TypeScript Node.js代码

在项目里建个src文件夹，里面建个index.ts文件，这就是TypeScript代码。比如写个简单的问候功能：

`typescript

// 定义一个函数，参数name必须是字符串，返回值也是字符串

function sayHello(name: string): string {

return 你好，${name}！;

}

// 调用函数，传字符串类型的参数

console.log(sayHello("TypeScript爱好者"));

`

这里和纯JavaScript不一样，参数name后面加了: string，这就是TypeScript的“类型标注”——相当于给代码加了个“规则说明”，后面如果传数字，比如sayHello(123)，保存的时候编译器就会直接报错，不用等运行才发现问题，是不是很省心？

第四步：转成Node.js能运行的代码

写完index.ts，在命令行输tsc，编译器就会把src里的所有.ts文件，按tsconfig.json的配置转成.js文件，放到dist文件夹里。比如刚才的代码转成dist/index.js，内容大概是：

`javascript

function sayHello(name) {

return 你好，${name}！;

}

console.log(sayHello("TypeScript爱好者"));

`

然后就可以用Node.js运行这个转好的代码了，输node dist/index.js，命令行就会输出“你好，TypeScript爱好者！”，和预期一样。

第五步：日常开发的小优化

要是每次改代码都要手动tsc转、再node运行，太麻烦了。可以装个nodemon，它能自动监听代码变化，转完直接运行。先装：npm install --save-dev nodemon ts-node，ts-node能跳过转成.js的步骤，直接运行.ts代码。然后在package.json里加个脚本：

`json

"scripts": {

"dev": "ts-node src/index.ts"

}

`

以后开发的时候，直接输npm run dev，改完代码会自动刷新运行，不用手动折腾转文件，效率高多了。

其实TypeScript和Node.js的组合，就是给Node.js加了“提前纠错”和“代码提示”的buff，不用记一堆函数的参数类型，编辑器会自动提醒，新手也能少踩坑。只要按这几步搭好基础，日常写接口、做工具都能用，慢慢熟练后还能用到更复杂的类型规则，让项目更稳妥。