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 关键字,否则类型剥离不会移除它们:
Dbsite企业网站管理系统V1.5.0 秉承"大道至简 邦达天下"的设计理念,以灵巧、简单的架构模式构建本管理系统。可根据需求可配置多种类型数据库(当前压缩包支持Access).系统是对多年企业网站设计经验的总结。特别适合于中小型企业网站建设使用。压缩包内包含通用企业网站模板一套,可以用来了解系统标签和设计网站使用。QQ技术交流群:115197646 系统特点:1.数据与页
// 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
阅读我们的博客









