vm 是 Node.js 核心模塊,提供 **V8 虛擬機級別的代碼編譯與執行能力**,支撐 require 機制與模塊系統運行。允許在隔離上下文中編譯、緩存、執行 JavaScript 代碼,適用於插件系統、用戶腳本、模板引擎、REPL、測試框架等場景。
| 方法 | 上下文隔離度 | global 共享 | 適用場景 |
|---|---|---|---|
vm.runInThisContext(code, options) | **不隔離**,共享當前 global | 是(同一 global) | 需訪問當前模塊變量、性能敏感 |
vm.createContext(sandbox) + vm.runInContext(code, context) | **完全隔離**,sandbox 成為新 global | 否(sandbox 為 global) | 不可信代碼、插件沙箱、多租戶隔離 |
vm.runInNewContext(code, sandbox, options) | **完全隔離**,自動創建 context | 否 | 一次性執行、簡化 API |
const vm = require('vm');
var p = 5;
global.p = 11;
vm.runInThisContext("console.log('ok', p)"); // 11 (讀取 global.p)
vm.runInThisContext("console.log(global)"); // 打印 global 對象
console.log(p); // 5 (局部變量 p 不受影響)
// 代碼無法訪問外部局部變量 p,只能訪問 global 掛載的屬性
const vm = require('vm');
const util = require('util');
const sandbox = {
p: 2,
vm, console, require // 手動注入需要的模塊
};
var p = 5;
global.p = 11;
vm.createContext(sandbox); // 將 sandbox 轉為 context(內部添加 global 等內建)
vm.runInContext('p = 3; console.log(typeof global);', sandbox);
// global 為 undefined(沙箱無 global,除非手動 sandbox.global = sandbox)
console.log(sandbox.p); // 3 (沙箱內修改生效)
console.log(util.inspect(sandbox)); // 查看沙箱完整狀態
vm.runInNewContext('p = 3;', sandbox); // 等同 createContext + runInContext
const sandbox = {p: 2, vm, console, require};
sandbox.global = sandbox; // 手動設置 global 指向自身
vm.runInNewContext(`
p = 3;
console.log(typeof global); // "object" (存在)
require('vm').runInThisContext("console.log(p)"); // 11 (訪問最頂層 global.p)
`, sandbox);
鐵律:runInThisContext **永遠訪問最頂層(宿主進程)的 global**,無視中間沙箱。沙箱內代碼調用 runInThisContext 會「穿透」沙箱直接操作真實 global。
vm.runInNewContext(templateCode, {data, helpers}) 安全渲染。vm.runInThisContext(newCode) 替換模塊導出(需配合模塊緩存清理)。console.log、setTimeout、白名單 require 封裝)。Object.freeze(sandbox.global) 防止原型污染。options: {timeout: 1000, breakOnSigint: true} 防止死循環佔用 CPU。runInThisContext 最快(無上下文切換),但無隔離。createContext 有開銷,複用 Context 執行多段代碼更高效。new vm.Script(code) 預編譯,多次 script.runInContext(ctx) 避免重複解析。