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 的结果为准,因为它优先使用当前项目声明的依赖。
按自己的节奏,确认真正理解。