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

在文章实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《Nodejs v：内置 TypeScript 支持终于来了》，聊聊，希望可以帮助到正在努力赚钱的你。

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

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

在 Node.js 中运行 TypeScript

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

node index.ts

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

Node.js 如何执行 TypeScript

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

Node.js 运行 TypeScript 的注意事项

本地导入必须引用 TypeScript 文件

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

import { myfunction } from './my-module.js';

现在必须改为：

import { myfunction } from './my-module.ts';

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

无内置类型检查

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

tsc --watch

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

{
  "compilerOptions": {
    "target": "esnext",
    "module": "nodeNext",
    "allowImportingTsExtensions": true,
    "rewriteRelativeImportExtensions": true,
    "verbatimModuleSyntax": true
  }
}

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

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

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

// Type import
import type { Item } from './my-module.ts';

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

Node.js 运行 TypeScript 的限制

不支持非 JavaScript 语言特性

一些 TypeScript 特性不受支持：

• 枚举
• 命名空间
• 类构造函数中的参数属性

可以使用 --experimental-transform-types 标志启用这些特性。

不支持 TypeScript 带来的未来 JavaScript 特性

TypeScript 允许通过转译在当前 JavaScript 引擎上运行即将推出的 JavaScript 特性（例如装饰器）。但 Node.js 仅移除类型，因此不支持这些特性。

旧版 Node.js 是否支持 TypeScript？

据 Marco On X 所述，Node.js v22 支持 TypeScript，但 v20 不支持。

参考

• Node 对 TypeScript 的新内置支持
• Node.js 现在默认支持 TypeScript

Leapcell：您将 Node.js 项目部署到云端的首选！

Leapcell 是一个下一代无服务器平台，支持 Web 托管、异步任务和 Redis：

• 多语言支持：Node.js、Python、Go 或 Rust。
• 免费部署无限项目：按使用付费。
• 高性价比：即付即用，无闲置费用。
• 简化的开发者体验：直观的 UI、自动化 CI/CD 和 GitOps 集成、实时监控和日志。
• 轻松扩展和高性能：自动扩展，零运维开销。

了解更多信息，请访问我们的文档！

关注我们：@leapcellhq

阅读我们的博客

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~