Node 24 四个内置能力实测:node:sqlite 建库 11ms、fs.glob 默认是回调版、--env-file 不

举报
yd_232353574 发表于 2026/10/25 08:10:52 2026/10/25
【摘要】 在 Node v24.13.1 上把 node:sqlite、fs.glob、--env-file、require(esm) 各跑一遍:1 万行事务插入 11ms;glob 的异步迭代要从 fs/promises 引;--env-file 不覆盖已存在的环境变量;带顶层 await 的 ESM 仍然不能被 require。

测试环境

  • 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.0ms
  • for 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 上重跑,换机器或换文件系统绝对时间会变,相对快慢在本地磁盘上基本稳定。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。