Vercel Edge Runtime究竟是什么？与Node.js的关联疑问咨询

1. Edge Runtime 到底是什么？ #

它不是完整的 Node.js，而是 Vercel 基于标准 Web API（如 Fetch API、Web Crypto、URL API 等）打造的轻量执行环境，核心目标是在边缘节点（离用户更近的服务器）快速运行代码，主打低延迟。它砍掉了 Node.js 中大量后端专属 API（比如fs文件系统、child_process进程管理这类模块），只保留 Web 标准 API 和部分适配的 Node.js API 子集。

2. 为什么官方说「It runs everywhere Node.js does」？ #

这句话的核心是兼容性适配，而非等同 Node.js：

• Vercel 为 Edge Runtime 做了一层兼容层，让它可以在 Node.js 环境中运行（比如本地开发时，你能借助 Node.js 来调试 Edge Runtime 代码）。
• 同时，Edge Runtime 支持的 Web 标准 API，是 Node.js 从 v18 版本开始逐步原生支持的（比如 Node.js 现在也有原生 Fetch API）。只要代码只用到双方共有的 API，就能在 Node.js 和 Edge Runtime 两边无缝运行。

3. 和 Node.js 的实际关联 #

• API 重叠：两者共享大量 Web 标准 API，Edge Runtime 也兼容部分 Node.js 常用 API（如process.env、Buffer），但并非全部 Node.js API 都被支持。
• 运行环境互通：Edge Runtime 代码可在 Node.js 中执行（借助 Vercel 工具链）；反过来，Node.js 代码如果只用到 Edge Runtime 支持的 API，也能部署到 Edge Runtime 环境。
• 底层同源：两者都基于 V8 引擎，但 Edge Runtime 没有 Node.js 的 libuv 等后端底层组件，因此更轻量、启动更快。

具体示例 #

可跨环境运行的代码

export default async function handler(request) {
  const res = await fetch('https://api.example.com/data');
  const data = await res.json();
  return new Response(JSON.stringify(data), {
    headers: { 'Content-Type': 'application/json' }
  });
}

这段代码仅使用标准 Fetch API，既能在 Node.js v18+ 中运行，也能直接部署到 Vercel Edge Runtime。

仅能在 Node.js 运行的代码

import fs from 'fs/promises';

export default async function handler() {
  const content = await fs.readFile('./data.txt', 'utf8');
  return new Response(content);
}

这段代码依赖 Node.js 专属的fs模块，在 Edge Runtime 中会报错，但在 Node.js 环境可正常执行。

内容的提问来源于stack exchange，提问作者LKB