必须先安装Node.js并配置PATH,再通过npm全局或本地安装TypeScript;验证后用tsc --init生成tsconfig.json,设置rootDir和outDir,最后用npx tsc编译src下的TS文件为dist中的JS。

要在Windows系统上安装TypeScript编译器并开始编写TS代码,必须先确保Node.js已正确安装,因为tsc命令依赖npm运行;若跳过这一步,后续所有命令都会报错“'tsc' is not recognized as an internal or external command”。
确认Node.js和npm已就位
按下 Win + R,输入 cmd 回车,打开命令提示符。
依次执行以下两条命令:
node -v → 查看Node.js版本,应返回类似 v20.15.1 的输出;
npm -v → 查看npm版本,应返回类似 10.9.0 的输出。
如果任一命令报错或无输出,说明Node.js未安装或PATH未配置。请前往 nodejs.org 下载LTS版安装包,勾选“Add to PATH”后完整安装。
安装TypeScript编译器
方法一:全局安装(适合快速验证与单项目起步)
在已打开的命令提示符中直接运行:
npm install -g typescript
安装完成后,立即验证:
tsc -v
成功时将显示类似 Version 5.8.3 的结果。若提示“tsc 不是内部或外部命令”,【请勿重装,而是将 %AppData%\npm 添加到系统环境变量PATH中】。
方法二:项目级本地安装(推荐用于团队协作或长期维护项目)
新建项目文件夹,例如 my-ts-app,进入该目录:
mkdir my-ts-app && cd my-ts-app
初始化npm项目:
npm init -y
安装TypeScript为开发依赖:
npm install typescript --save-dev
此时tsc命令不可直接调用,需通过npx使用:
npx tsc -v
生成tsconfig.json配置文件
第一步:在项目根目录下运行
npx tsc --init
该命令会生成标准 tsconfig.json 文件,包含全部可配选项(大部分被注释)。
第二步:用记事本或VS Code打开 tsconfig.json,取消以下两行的注释并修改值:
"rootDir": "./src",
"outDir": "./dist",
第三步:手动创建对应文件夹:
在项目根目录下新建 src 文件夹,用于存放 .ts 源文件;
无需新建 dist,tsc 编译时会自动创建。
注意:若不设 rootDir,而源文件放在项目根目录,编译时可能把 tsconfig.json 本身也当作输入文件处理,导致意外错误。
编写并编译第一个TS文件
在 src 文件夹中新建 index.ts,写入以下内容:
const message: string = "Hello from TypeScript"; console.log(message);
回到命令提示符,确保当前路径为项目根目录(即含 tsconfig.json 的目录),执行:
npx tsc
编译成功后,dist 文件夹内将生成 index.js 和 index.js.map。
最后,在命令提示符中运行生成的JS文件:
node dist/index.js
终端将输出:Hello from TypeScript。


















