Node.js 现在默认支持 TypeScript
版权声明
翻译与转载须知：
本译文仅供教育和信息交流之用。所有知识产权（包括版权）均归原作者和/或出版商所有。本译文在保持原文内容完整性的同时，旨在使其更易于中文读者理解。
修改声明：
- 本文为原文的完整忠实译本，未进行任何实质性修改。
- 本译文包含为提升中文读者清晰度而做的微小调整，同时保留了所有基本信息和观点。
- 标有 [†] 的部分包含译者为提供文化或技术背景而添加的补充说明。
权利保留：
如果您是版权所有者，并认为本译文超出了合理使用范围，请通过 邮箱 与我们联系。我们致力于尊重知识产权，并将及时处理任何正当关切。
核心要点
Node 23 即将能够无需任何额外配置直接运行 TypeScript 文件。
Marco Ippolito（过去一年一直推动 Node 中的 TypeScript 支持）在 Node 23 中提交了一个 PR，取消了对 --experimental-strip-types 的实验性标记。
实际上，这意味着：
- 你可以创建包含
TS语法（如类型注解）的index.ts文件。 - 你可以直接运行
node index.ts，无需任何额外参数。 Node将使用swc的一个版本来剥离类型，然后运行生成的代码。
常见问题解答
如何尝试这个功能？
该功能现已在 Node Nightly 版本中可用，正如 Marco 所提到的。几天后它很可能会在 Node 23 中发布。更新：看起来它将在 23.6.0 版本中推出。
Node 会对我的文件进行类型检查吗？
不会。Node 在运行文件时不会进行类型检查。这是一件好事 - 这意味着类型检查可以在与应用程序运行分离的进程中进行。你需要在本地运行 tsc --watch 来在工作时检查应用程序的类型。
tsconfig.json 中应该包含什么？
这是我的 TSConfig 速查表 的定制版本：
{
"compilerOptions": {
/* Base Options: */
"esModuleInterop": true,
"skipLibCheck": true,
"target": "es2022",
"allowJs": true,
"resolveJsonModule": true,
"moduleDetection": "force",
"isolatedModules": true,
"verbatimModuleSyntax": true,
/* Strictness */
"strict": true,
"noUncheckedIndexedAccess": true,
"noImplicitOverride": true,
/* Node Stuff */
"allowImportingTsExtensions": true,
"rewriteRelativeImportExtensions": true,
"module": "NodeNext",
"noEmit": true,
/* If your code doesn't run in the DOM: */
"lib": ["es2022"]
}
}这在 TS 5.8 中可能会发生变化，TypeScript 团队计划发布一个兼容性标志。目前尚不确定具体内容，但它将使与 Node 的 TS 支持的互操作性更容易。
支持枚举和命名空间吗？
默认情况下不支持枚举和命名空间。查看 此处 了解其他不支持的功能。如果你想支持其他 TS 功能，可以添加 --experimental-transform-types 使其工作。
我对此并不太难过，尤其是关于 枚举 这部分。
注意，不支持运行时命名空间，但支持仅类型命名空间（使用 declare namespace）。这很好 - 我喜欢仅类型命名空间。
生产环境中需要将代码转译为 JavaScript 吗？
Node 应用
如果你将代码部署到无服务器平台，是的。转译和压缩代码对于获得良好的冷启动至关重要。
如果你部署到冷启动影响较小的地方，那么可能不需要！在应用程序最初加载 TypeScript 时会有一点小成本（确实很小），但一旦进程运行，不太可能导致速度减慢。
一个可能的问题是，如果你的代码在处理过程中动态加载其他 TypeScript 文件。这可能会导致一些额外的速度减慢 - 所以谨慎行事。
库
是的，在将库发布到 NPM 之前，你仍然需要将 TypeScript 转译为 JavaScript。原因有两个：
- 让
JavaScript用户仍然可以使用你的库。 TypeScript在使用声明文件（.d.ts文件）时运行更快，所以不提供这些文件意味着你使消费者的TS体验变慢。
Monorepos
如果你在 monorepo 中创建一个库，仅供该 monorepo 使用，我仍然建议将 TypeScript 文件转译为 JavaScript。
原因与库相同 - monorepo 中的 .d.ts 文件越多，TS 体验就越快。
这个功能会来到之前的 Node 版本吗？
是的，TypeScript 支持将会添加到 Node 22，但不会添加到 Node 20。Marco 在 X 平台上 提到了这一点。
XiSenao