JavaScript / TypeScript / 系统课时
安装编译器
安装编译器
本课完成一个最小 TypeScript 项目的初始化与编译器安装,并通过项目本地命令确认版本。完成后,你可以稳定地执行 tsc,避免团队成员因全局版本不同产生构建差异。
学习目标
- 在项目中安装 TypeScript 开发依赖
- 使用项目本地编译器执行命令
- 验证安装结果并处理常见命令错误
安装前检查与项目初始化
先确认 Node.js 和包管理器可以使用。以下示例使用 npm,Node.js 版本号可能因环境不同而变化。
node --version
npm --version预期输出:
v<MAJOR>.<MINOR>.<PATCH>
<NPM_VERSION>若命令不存在,需要先安装 Node.js。建议使用仍在维护的 LTS 版本,并在安装后重新打开终端。
创建独立目录,初始化 package.json,再把 TypeScript 安装为开发依赖。最后一条命令读取刚写入的版本范围,用于确认依赖已经记录。
mkdir ts-quickstart
cd ts-quickstart
npm init -y
npm install --save-dev typescript
npm pkg get devDependencies.typescript预期输出的最后一行类似:
"<TYPESCRIPT_VERSION_RANGE>"项目中还会出现 node_modules、package-lock.json,并在 package.json 的 devDependencies 中记录 TypeScript。具体版本范围和安装耗时会因执行时间与网络环境不同而变化。
确认版本并验证编译
使用 npx 调用当前项目中的 tsc:
npx tsc --version预期输出:
Version <TYPESCRIPT_VERSION>也可以让 npm 显示已安装的依赖树:
npm list typescript预期输出:
ts-quickstart@1.0.0 <PATH>
└── typescript@<TYPESCRIPT_VERSION><PATH> 和 <TYPESCRIPT_VERSION> 是动态值。两条命令显示的版本应保持一致,否则需要检查当前目录、锁文件或全局命令干扰。
确认版本后,生成基础配置文件:
npx tsc --init预期结果:
Created a new tsconfig.json不同版本的提示文字可能略有差异,但项目根目录应出现 tsconfig.json。随后创建 index.ts:
const message: string = "TypeScript ready";
console.log(message);执行编译和运行:
npx tsc index.ts
node index.js预期输出:
TypeScript ready看到输出且目录中生成 index.js,说明编译器安装、命令调用和基础编译链路均正常。
典型失败处理
出现 npx: command not found 时,通常是 Node.js 或 npm 未正确安装。出现 Cannot find module 或安装中断时,可先确认网络、代理和当前目录,再重新执行 npm install。
若直接运行 tsc --version 得到的版本与 npx tsc --version 不同,前者通常来自全局安装。项目命令应优先使用 npx tsc 或写入 npm scripts,确保团队和持续集成环境使用同一依赖来源。
本课总结
- TypeScript 应优先作为项目开发依赖安装,而不是只依赖全局命令
npx tsc --version可以确认当前项目实际使用的编译器版本- 通过生成配置、编译文件并运行 JavaScript,可以完整验证安装链路
下一课预告
下一课将创建并解读 tsconfig.json,重点掌握输入目录、输出目录和严格类型检查等常用配置。