如何配置TypeScript运行环境？

TypeScript作为JavaScript的超集，需要专门的编译环境才能运行，很多新手第一次配置时容易卡壳，下面一步步讲解完整的配置流程。

前置准备：安装Node.js

TypeScript的包管理和编译器运行都依赖Node.js环境，首先去Node.js官网下载对应系统的长期支持版本，安装完成后打开终端输入以下命令验证是否安装成功：

# 查看Node.js版本
node -v
# 查看npm版本
npm -v

如果终端能正常输出版本号，说明Node.js环境已经就绪。

安装TypeScript编译器

Node.js自带npm包管理工具，我们可以通过npm全局安装TypeScript编译器，执行以下命令：

npm install -g typescript

安装完成后输入tsc -v命令，如果能看到TypeScript的版本号，说明编译器安装成功。

初始化项目与配置文件

新建一个项目文件夹，进入文件夹后执行初始化命令生成tsconfig.json配置文件：

npm init -y
tsc --init

生成的tsconfig.json包含大量默认配置，我们可以根据实际需求调整常用参数，比如：

• target：指定编译后的JavaScript版本，默认是ES5，可根据需求改为ES6、ES2020等
• module：指定模块系统，常用commonjs、esnext等
• outDir：指定编译后的JavaScript文件输出目录，避免和源码混在一起
• rootDir：指定TypeScript源码的存放目录
• strict：开启严格模式，建议保持开启，能提前发现很多类型错误

以下是一个简单的配置示例：

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

编写测试代码验证环境

在项目根目录下新建src文件夹，在里面创建index.ts文件，写入以下测试代码：

// 定义一个字符串类型的变量
const greeting: string = "Hello TypeScript";
// 定义一个函数，接收字符串参数并打印
function printMsg(msg: string): void {
  console.log(msg);
}
// 调用函数
printMsg(greeting);

回到终端执行编译命令：

tsc

如果配置正确，会在dist目录下生成对应的index.js文件，然后执行以下命令运行编译后的文件：

node dist/index.js

终端输出Hello TypeScript就说明TypeScript运行环境已经配置成功，可以正常开发项目了。

可选：配置自动编译

每次修改代码都要手动执行tsc命令比较麻烦，可以开启TypeScript的监听模式，自动编译修改的文件：

tsc --watch

这样只要src目录下的TypeScript文件有修改，就会自动重新编译，提升开发效率。

TypeScriptNode.jsnpmtsconfig.json修改时间：2026-06-02 04:59:00