0Pricing
TypeScript Academy · 课时

@types/node、Node 中的 ESM 与 CJS

@types/node 为 Node API 提供类型定义，而 tsconfig 的模块选项可以让您在 CommonJS 和 ESM 之间进行选择。

@types/node、Node 中的 ESM 与 CJS 是 CoddyKit 上的免费 TypeScript Academy 课时。 这是第 1 节课，共 2 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 2 节课。

简介

目标：使用 @types/node 提供类型安全，并配置 TS 以处理 CommonJS 和 ES 模块。

安装类型定义

安装 @types/node，即可获得 Node 内置 API（例如 fs 和 path）的类型定义。

npm install --save-dev @types/node

Node 全局变量

借助 @types/node，process、__dirname 和 __filename 等全局变量都会获得类型识别。

console.log(process.version);
console.log(__dirname);
console.log(__filename);

CJS 示例

CommonJS：Node 中的默认模块系统。使用 require 和 module.exports。

// CommonJS style
const fs = require("fs");
const data = fs.readFileSync("file.txt", "utf8");
console.log(data);

ESM 示例

ESM：使用 import/export 的现代语法。需要在 tsconfig 中设置 "module": "ESNext"，并在 package.json 中设置 "type": "module"。

// ES Module style
import fs from "fs";
const data = fs.readFileSync("file.txt", "utf8");
console.log(data);

tsconfig 模块设置

在 tsconfig.json 中控制模块系统。将 module 切换为 CommonJS 或 ESNext。

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "CommonJS",
    "moduleResolution": "node"
  }
}

类型定义检查

快速检查：为什么要安装 @types/node？

回顾

回顾：@types/node 添加类型定义。CommonJS 使用 require，ESM 使用 import。tsconfig 决定模块系统。

常见问题解答

「@types/node、Node 中的 ESM 与 CJS」课时是免费的吗？

是的 — 「@types/node、Node 中的 ESM 与 CJS」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 2 节课。

「@types/node、Node 中的 ESM 与 CJS」这节课中我会学到什么？

@types/node 为 Node API 提供类型定义，而 tsconfig 的模块选项可以让您在 CommonJS 和 ESM 之间进行选择。 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 2 节。

「@types/node、Node 中的 ESM 与 CJS」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 TypeScript Academy 课中编写并运行代码吗？

能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. @types/node、Node 中的 ESM 与 CJS
  2. 运行时选项（ts-node/tsx）与源映射
← 返回 TypeScript Academy