Node 24 四个内置能力实测:node:sqlite 建库 11ms、fs.glob 默认是回调版、--env-file 不
测试环境
- Windows 10(19045)、Node v24.13.1、npm 11.8.0、V8 13.6
- 全程不装任何依赖,四个能力都来自 Node 自带模块
- 计时题都是多轮交替执行取中位数(SQLite 5 轮、glob 7 轮);冷启动和热路径差别很大,混在一起看会得出相反结论
一、node:sqlite:小工具够用了
内存库建表、批量写入:
import { DatabaseSync } from 'node:sqlite';
const db = new DatabaseSync(':memory:');
db.exec('CREATE TABLE t(id INTEGER PRIMARY KEY, name TEXT, score REAL)');
const ins = db.prepare('INSERT INTO t(name,score) VALUES(?,?)');
db.exec('BEGIN');
for (let i = 0; i < 10000; i++) ins.run('user' + i, Math.random() * 100);
db.exec('COMMIT');
1 万行包在事务里中位 11ms,不写事务 23ms(内存库,单条 prepared statement 复用)。内存库上事务带来的差距只有两倍上下,换成文件库会拉开更多。count(*) + avg(score) 0.6ms;1 万次按主键点查,把 statement 提到循环外是 19ms,每次循环里重新 prepare 是 142ms,相差 7 倍多。sqlite_version() 返回 3.51.2。
三个要注意的地方:
- 启动必打一条
ExperimentalWarning: SQLite is an experimental feature and might change at any time,Node 24.13.1 还没摘标,日志里有告警不代表出错。 - API 是同步的。
DatabaseSync在命令行工具、构建脚本里很省事,放进 HTTP 处理函数里跑大查询会直接堵住事件循环。 - 批量写入记得包 BEGIN/COMMIT,内存库差两倍,文件库差距更大。
二、fs.glob:默认拿到的是回调版
第一版代码照文档写:
import { glob } from 'node:fs';
for await (const f of glob('tree/**/*.js')) { /* ... */ }
直接抛 TypeError [ERR_INVALID_ARG_TYPE]: The "cb" argument must be of type function。node:fs 导出的 glob 是回调版,异步迭代那个在 node:fs/promises:
import { glob } from 'node:fs/promises';
测法:造一棵 20 个目录、每目录 50 个 .js 的树,共 1000 个文件,三种写法在同一个进程里交替跑 7 轮。
globSync('tree/**/*.js'):7 轮中位 15.0msfor await (const f of glob(...))(fs/promises):7 轮中位 21.5ms- 手写
readdir递归:7 轮中位 9.7ms
首轮数字全被文件系统冷缓存拖高,冷启动能到 30ms 上下,只报首轮会得出「glob 慢三倍」的错误结论。热路径上 glob 仍然比手写递归慢一半到一倍:这个规模下它换来的是更短的代码,速度上没有优势。
另外 Windows 上返回的路径是反斜杠(实测 tree\d9\sub\f0.js),要拼 URL、写进正则或配置文件,先自己转一遍。
三、--env-file 的三个反直觉行为
先写一个 .env:
# comment line
A=1
B="two words"
C=${A}+suffix
D='single $A'
export E=fromexport
F=unquoted value here
node --env-file=test.env app.mjs 实测:
- 启动时环境里已经有
A=preset:进程里A仍是preset,文件不覆盖已有值 C=${A}+suffix:拿到原样字符串${A}+suffix,不做变量展开- 文件不存在:
node.exe: nope.env: not found,进程直接不启动 - 两个
--env-file都写A:后一个生效
其它细节:export E=... 前缀能识别;双引号会被去掉并保留中间空格;单引号里的 $A 保持字面量;不带引号的值中间有空格也整段保留(F 拿到 unquoted value here)。
最需要记的是第一条:容器或 CI 里已经注入同名变量时,改 .env 完全没效果,而且没有任何提示。排查配置问题前先把 process.env 打出来,比对着文件找半天快得多。
四、require(esm) 能用了,顶层 await 还不行
CommonJS 里直接 require 一个普通 .mjs:
const m = require('./esm_mod.mjs');
// m.answer === 42,m.default 是函数,m.later 也是函数
拿到的是模块命名空间,export default 落在 m.default 上。
带顶层 await 的模块就断了:
ERR_REQUIRE_ASYNC_MODULE: require() cannot be used on an ESM graph
with top-level await. Use import() instead.
反方向从 ESM 引 CommonJS,写法决定成败:
// cjs_mod.cjs
module.exports = { add: (a, b) => a + b, name: 'cjs' };
import { add } from './cjs_mod.cjs'; // SyntaxError: Named export 'add' not found
import pkg from './cjs_mod.cjs'; // 可以,用 pkg.add
改成逐个挂载就有具名导出了:
// cjs_mod2.cjs
exports.add = (a, b) => a + b;
exports.name = 'cjs2';
import { add, name } from './cjs_mod2.cjs'; // 正常
老项目迁移时最容易踩的就是这一条:同一个 module.exports = {...} 写法,按 CJS 用没问题,被 ESM 具名引用就报错。
最后,ESM 里也能 require:
import { createRequire } from 'node:module';
const require = createRequire(import.meta.url);
console.log(require('./esm_mod.mjs').answer); // 42
四个能力里,能立刻减依赖的是 node:sqlite(省掉原生编译的 sqlite3)和 --env-file(省掉 dotenv)。fs.glob 在已经有递归函数的项目里不着急换,它换来的是写法短,不是更快。require(esm) 适合模块图里没有顶层 await 的场景,老代码想复用新写的 ESM 模块时够用。上面的数字都能在 Node 24.13.1 上重跑,换机器或换文件系统绝对时间会变,相对快慢在本地磁盘上基本稳定。
- 点赞
- 收藏
- 关注作者
评论(0)