JavaScript / TypeScript / 系统课时

安装 Node.js 与 TypeScript

安装 Node.js 与 TypeScript

本课完成 TypeScript 开发环境的基础安装。最终你将能够确认 Node.js、npm 和 TypeScript 编译器均可用,并知道遇到命令不存在或版本异常时应按什么顺序排查。

学习目标

  • 安装并验证 Node.js 与 npm
  • 安装项目级 TypeScript 编译器
  • 处理命令找不到和版本不一致问题

安装前检查

TypeScript 编译器通常通过 npm 安装,因此先确认系统是否已有 Node.js。建议安装当前长期支持版 Node.js;安装包会同时提供 node 和 npm 命令。在终端执行:

bash
node --version
npm --version

预期输出

text
v..
..

版本号会随安装时间变化。若系统提示命令不存在,应先重新打开终端;仍无效时再检查 Node.js 是否安装成功以及安装目录是否加入 PATH。

创建练习目录

将 TypeScript 安装在项目内部,可以避免不同项目互相影响版本。

bash
mkdir typescript-basics
cd typescript-basics
npm init -y

预期结果

text
当前目录生成 package.json,命令正常结束。

npm init -y 会创建最小项目清单。文件中的版本、许可证等默认值后续可以按项目需要修改。

安装 TypeScript

执行以下命令,把 TypeScript 记录为开发依赖:

bash
npm install --save-dev typescript

预期结果

text
安装完成,并在 package.json 的 devDependencies 中出现 typescript。

不要依赖全局安装来保证项目可复现。项目级依赖会把所需版本写入 package.json 和锁文件,团队成员执行安装命令后即可获得一致环境。

验证编译器

使用 npx 调用当前项目中的编译器:

bash
npx tsc --version

预期输出

text
Version ..

这里的版本可能与教程编写时不同,只要命令成功并输出有效版本号即可。还可以确认依赖记录:

bash
npm ls typescript

预期输出

text
typescript-basics@1.0.0 
└── typescript@..

`` 和具体版本取决于本机环境。

典型失败处理

出现 node 或 npm 找不到时,优先检查终端是否重启、安装是否完整以及 PATH 是否正确。出现 npx tsc 找不到时,确认当前目录包含 package.json,再重新执行 npm install。

若全局 tsc 与项目版本不一致,以 npx tsc 的结果为准,因为它优先使用当前项目声明的依赖。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 Node.js 与 TypeScript

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通