Axios, Got, Node-Fetch 与 Isomorphic-Fetch 深度对比

在 JavaScript 生态中，发送 HTTP 请求是几乎所有应用的基础需求。axios、got、node-fetch 和 isomorphic-fetch 代表了四种不同的解决方案。它们各有优劣，适用于不同的架构场景。本文将从环境兼容性、API 设计、拦截器机制及现代环境适配性等方面进行深度对比。

🌍 运行环境兼容性：同构 vs 专有

选择请求库的首要条件是看它能否在你的目标环境中运行。

axios 是同构库，同一份代码可直接运行在浏览器和 Node.js 中。

• 内部根据环境自动切换底层实现（浏览器用 XMLHttpRequest，Node 用 http 模块）。
• 适合全栈项目或需要代码复用的场景。

// axios: 浏览器和 Node 通用
import axios from 'axios';
const res = await axios.get('/api/data');

got 专为 Node.js 设计，无法直接在浏览器中使用。

• 依赖 Node.js 特有的流和 DNS 缓存功能。
• 适合纯后端服务、CLI 工具或服务器端脚本。

// got: 仅 Node.js
import got from 'got';
const res = await got.get('/api/data').json();

node-fetch 是 Node.js 环境下的 Fetch API 实现。

• 旨在让 Node 代码使用与浏览器一致的 fetch 语法。
• 无法直接在浏览器使用（浏览器已有原生 fetch）。

// node-fetch: 仅 Node.js
import fetch from 'node-fetch';
const res = await fetch('/api/data');

isomorphic-fetch 是一个 polyfill，用于在不支持 fetch 的环境中注入全局 fetch。

• 同时支持浏览器和 Node.js，但目的是填补空白。
• 现代环境（Node 18+ 及现代浏览器）已原生支持，不再需要此库。

// isomorphic-fetch:  polyfill 全局 fetch
import 'isomorphic-fetch';
const res = await fetch('/api/data');

🛠️ API 设计与使用体验

API 的设计直接影响代码的可读性和维护成本。

axios 使用基于 Promise 的对象方法，自动转换 JSON。

• 响应数据直接在 res.data 中，无需手动解析。
• 支持简洁的快捷方法如 axios.post。

// axios: 自动 JSON 解析
const response = await axios.post('/user', { name: 'Alice' });
console.log(response.data); 

got 采用链式调用，明确区分响应体处理方式。

• 需要显式调用 .json() 或 .text() 来获取内容。
• 提供更丰富的选项配置，如 pagination。

// got: 显式 JSON 解析
const response = await got.post('/user', { json: { name: 'Alice' } });
console.log(response.body); 

node-fetch 完全遵循 WHATWG Fetch 标准。

• 响应体需要手动调用 .json() 方法解析。
• 符合 Web 标准，便于从浏览器代码迁移。

// node-fetch: 手动 JSON 解析
const response = await fetch('/user', { method: 'POST', body: JSON.stringify({ name: 'Alice' }) });
const data = await response.json();

isomorphic-fetch 用法与 node-fetch 完全一致，因为它只是注入全局。

• 代码看起来像原生 fetch。
• 依赖运行环境是否已成功 polyfill。

// isomorphic-fetch: 同原生 fetch
const response = await fetch('/user', { method: 'POST', body: JSON.stringify({ name: 'Alice' }) });
const data = await response.json();

🛡️ 拦截器与中间件机制

在处理认证、日志或错误统一处理时，拦截器非常重要。

axios 内置强大的请求和响应拦截器。

• 可以轻松添加 Token 或统一处理 401 错误。
• 无需额外依赖即可实现复杂逻辑。

// axios: 内置拦截器
axios.interceptors.request.use(config => {
  config.headers.Authorization = 'Bearer token';
  return config;
});

got 支持插件系统和钩子（Hooks）。

• 可以在请求前、后或错误时执行函数。
• 比 axios 更灵活，支持流式拦截。

// got: 钩子机制
const client = got.extend({
  hooks: {
    beforeRequest: [options => { options.headers.authorization = 'Bearer token'; }]
  }
});

node-fetch 没有内置拦截器。

• 需要自行封装函数或使用第三方中间件库。
• 保持了 API 的轻量，但增加了重复代码。

// node-fetch: 手动封装
async function fetchWithAuth(url) {
  const res = await fetch(url, { headers: { Authorization: 'Bearer token' } });
  return res;
}

isomorphic-fetch 同样没有内置拦截器。

• 依赖全局 fetch，无法直接修改库行为。
• 必须通过封装全局 fetch 或自行实现逻辑。

// isomorphic-fetch: 手动封装全局
const originalFetch = global.fetch;
global.fetch = (url, opts) => originalFetch(url, { ...opts, headers: { ... } });

⚠️ 错误处理机制

网络请求失败时的处理方式决定了系统的健壮性。

axios 将 HTTP 错误状态（如 404, 500）视为 Promise 拒绝。

• 统一在 catch 块中处理所有错误。
• 提供详细的错误对象包含请求配置和响应信息。

// axios: 统一捕获
try {
  await axios.get('/api/fail');
} catch (error) {
  console.log(error.response?.status); 
}

got 默认也将 HTTP 错误视为拒绝，但可配置。

• 提供具体的错误类型（如 RequestError, HTTPError）。
• 便于区分网络错误和业务错误。

// got: 错误分类
try {
  await got.get('/api/fail');
} catch (error) {
  console.log(error.code); 
}

node-fetch 默认不将 HTTP 错误状态视为 Promise 拒绝。

• 只有网络故障才会 reject。
• 需要手动检查 res.ok 或 res.status。

// node-fetch: 手动检查状态
const res = await fetch('/api/fail');
if (!res.ok) throw new Error(`HTTP error ${res.status}`);

isomorphic-fetch 行为与 node-fetch 一致，遵循 Fetch 标准。

• 需要手动处理非 200 状态码。
• 容易遗漏错误检查导致静默失败。

// isomorphic-fetch: 手动检查状态
const res = await fetch('/api/fail');
if (!res.ok) throw new Error(`HTTP error ${res.status}`);

🚀 现代 Node.js 环境下的选型

随着 Node.js 18+ 正式支持全局 fetch，格局发生了变化。

axios 依然保持优势。

• 即使有原生 fetch，axios 的拦截器和自动转换仍具价值。
• 适合需要稳定 API 和广泛社区支持的企业项目。

got 在 Node 服务端依然强劲。

• 原生 fetch 缺乏流式处理和高级重试机制。
• 适合需要高性能和细粒度控制的后端服务。

node-fetch 逐渐过渡为兼容层。

• 在 Node 18+ 项目中，可直接使用全局 fetch。
• 仅在需要支持旧版 Node 或特定 ESM 兼容性问题时使用。

isomorphic-fetch 已不再推荐用于新项目。

• 现代浏览器和 Node 18+ 均已原生支持 fetch。
• 引入此库会增加不必要的依赖和 bundle 体积。

// 现代 Node.js (18+) 推荐直接使用全局 fetch
const res = await fetch('/api/data'); // 无需 import

📊 总结对比表

💡 最终建议

axios 是最稳妥的通用选择 🛡️。如果你的团队需要一套代码多处运行，或者依赖拦截器管理认证，它依然是首选。它的自动 JSON 转换能减少大量样板代码。

got 是 Node.js 后端的高级工具 🔧。当你需要处理流、复杂重试逻辑或高频服务端请求时，它的性能和控制力优于 axios。

node-fetch 是过渡期的标准实现 🌉。如果你的项目必须运行在 Node 18 以下且希望使用 fetch 语法，它是最佳选择。否则，建议直接升级到新版 Node 使用原生 fetch。

isomorphic-fetch 建议避免使用 ❌。除非你必须支持非常旧的环境且无法升级构建工具，否则现代项目应直接使用原生 fetch 或 axios。

核心结论：新项目优先考虑 原生 fetch (现代环境) 或 axios (需要拦截器/同构)；纯 Node 高级场景选 got；避免在新项目中使用 isomorphic-fetch。