Node.js 22 新特性

November 29, 2024

Node.js 22 已成为 LTS 版本了。让我们快速过一下 Node22 相比 Node20 新增的实验特性和已稳定的实验级特性！

截止编写日期，下面以 Node 20.18.1 和 Node 22.11.0 为例

稳定功能

--run

可以看作是精简版的 npm run，支持搜寻上层目录的 package.json 和添加 ./node_modules/.bin 到 PATH。
不支持 pre 和 post hook。

另外，在传递额外参数时需要：

node --run test -- --verbose

对于 npm，则只对 - 开头的参数要求必须使用额外的 --。

简单起见，总是使用额外的 -- 就好。node 和 npm 解析命令行参数策略不同，本文就不深入了。

--watch

--watch 已稳定！

不稳定功能

--experimental-require-module

启用后，支持在 CommonJS 模块中使用 require() 导入同步 ES 模块

--experimental-strip-types

Node 实现了一个叫 amaro 的 @swc/wasm-typescript 包装层，实现了类型擦除。

启用此选项后支持导入和运行 .ts .mts .cts 脚本，仅做类型擦除（可以理解为将类型部分替换为空格）。
不支持 tsconfig.json，当然也不支持 .tsx。

TypeScript 5.7 之前需要启用 allowImportingTsExtensions 才支持导入 .ts 后缀。
并且 tsc 编译器实际上避免重写任何路径，因此开启 allowImportingTsExtensions 的同时必须同时启用 noEmit

TypeScript 5.7 支持 rewriteRelativeImportExtensions 来启用编译器对 .ts .tsx .cts .mts 后缀的相对导入路径改写。

必须满足ts 文件后缀和相对路径，才会改写！否则会保留原样。以下情况不会改写：

import "some-package/file.ts";

import "#root/file.ts";
// package.json
{
    "name": "my-package",
    "imports": {
        "#root/*": "./dist/*"
    }
}

import "@/file.ts";
// tsconfig.json
{
    "compilerOptions": {
        "module": "nodenext",
        // ...
        "paths": {
            "@/*": ["./src/*"]
        }
    }
}