node.js v23.6.0 重磅更新：原生支持 typescript！告别额外配置，直接运行 .ts 文件。
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 关键字，否则类型剥离不会移除它们：
<code class="typescript">// Type import
import type { Item } from './my-module.ts';
// Inline type import
import { myFunction, type Item } from './my-module.ts';</code>
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
阅读我们的博客
