Nodejs v：内置 TypeScript 支持终于来了-js教程-PHP中文网

Nodejs v：内置 TypeScript 支持终于来了

霞舞

发布： 2025-01-10 08:09:33

原创

1077人浏览过

node.js v23.6.0 重磅更新：原生支持 typescript！告别额外配置，直接运行 .ts 文件。

Nodejs v：内置 TypeScript 支持终于来了

TypeScript 的重要性不言而喻，它为 JavaScript 增加了可选静态类型和高级特性（如接口、泛型和类型推断），成为大型 JavaScript 应用的业界标准。Node.js 的原生支持让后端开发者更轻松地使用 TypeScript。

在 Node.js 中运行 TypeScript

运行 TypeScript 文件，只需简单执行：

<code class="bash">node index.ts</code>

登录后复制

Node.js 支持 .ts、.mts 和 .cts 文件，但不支持 .tsx。

Node.js 如何执行 TypeScript

Node.js 利用 swc 来移除类型注释，留下可执行的纯 JavaScript 代码。

Node.js 运行 TypeScript 的注意事项

本地导入必须引用 TypeScript 文件

在无打包工具的环境中，之前的导入方式可能如下：

<code class="javascript">import { myfunction } from './my-module.js';</code>

登录后复制

现在必须改为：

<code class="javascript">import { myfunction } from './my-module.ts';</code>

登录后复制

这是因为 Node.js 使用文件扩展名确定模块类型，而 TypeScript 编译器不会修改 './my-module.js' 等模块扩展名。

无内置类型检查

Node.js 不会在运行时进行类型检查。为了保证类型安全，需要本地运行 TypeScript 编译器 (tsc) 或类似工具，例如：

<code class="bash">tsc --watch</code>

登录后复制

同时，正确配置 tsconfig.json 至关重要：

<code class="json">{
  "compilerOptions": {
    "target": "esnext",
    "module": "nodeNext",
    "allowImportingTsExtensions": true,
    "rewriteRelativeImportExtensions": true,
    "verbatimModuleSyntax": true
  }
}</code>

登录后复制

allowImportingTsExtensions：允许直接导入 .ts 文件。
rewriteRelativeImportExtensions：将 .ts 文件的相对导入重写为 .js 文件的相对导入。
verbatimModuleSyntax：避免在不使用 type 关键字导入类型时发出警告。

必须使用 type 关键字导入类型

导入类型时必须使用 type 关键字，否则类型剥离不会移除它们：

知了zKnown

知了zKnown：致力于信息降噪 / 阅读提效的个人知识助手。

查看详情

<code class="typescript">// Type import
import type { Item } from './my-module.ts';

// Inline type import
import { myFunction, type Item } from './my-module.ts';</code>

登录后复制