如何开启 WebNN：Edge / Chrome 完整设置与排查教程

WebNN Edge Chrome NPU 浏览器AI

如何开启 WebNN：Edge / Chrome 完整设置与排查教程

WebNN 让网页调用系统的机器学习加速能力，例如 NPU 或 GPU。目前它在部分浏览器和平台上仍属于实验或预览能力，浏览器版本、操作系统、驱动和硬件都会影响结果。

网站不能代替你打开浏览器实验开关。如果工具提示“WebNN 不可用”或“WebNN API 可用，但 NPU/GPU 不可用”，请按下面步骤设置。

最快开启方法

Windows 用户优先使用最新版 Microsoft Edge Beta；需要测试 NPU 时，使用最新版 Edge Canary。

  1. 更新 Windows 11，并安装电脑厂商或显卡厂商提供的最新 NPU/GPU 驱动。
  2. 在地址栏打开 edge://flags。
  3. 搜索 WebNN API。
  4. 将对应选项改为 Enabled。
  5. 点击 Restart，或关闭所有 Edge 窗口后重新打开。
  6. 返回本站，刷新页面，再查看 WebNN 状态。

如果搜索不到 WebNN API，说明当前浏览器版本或平台没有公开这个实验选项。先更新浏览器；仍没有时，改用 Edge Beta 或 Edge Canary。

在 Chrome 中开启

  1. 更新到最新版 Chrome 或 Chrome Canary。
  2. 在地址栏打开 chrome://flags。
  3. 搜索 WebNN API。
  4. 将对应选项改为 Enabled。
  5. 完全重启 Chrome，再刷新工具页面。

不同 Chromium 版本可能会更名、隐藏或默认开启该选项。不要依赖固定的 flag 编号，以浏览器页面中实际出现的 WebNN API 选项为准。

NPU 仍不可用怎么办

WebNN 已开启，不代表设备一定能创建 NPU 上下文。你还需要支持的 NPU、对应驱动和浏览器后端。

Microsoft 的预览文档还给出了一个 NPU 启动参数：

msedge.exe --disable_webnn_for_npu=0

只在最新版 Edge Canary 已开启 WebNN、但仍无法检测 NPU 时尝试此参数。它属于预览设置，后续版本可能取消或更名。普通 GPU 加速不需要这一步。

确认页面使用安全环境

WebNN 是受限制的强大功能，只能在安全上下文中使用。线上页面应使用 HTTPS；本地开发请使用 localhost 或 127.0.0.1。

以下环境可能导致 navigator.ml 不出现：

  • 使用普通 HTTP 打开局域网页面。
  • 页面嵌入在未授权 WebNN 的第三方 iframe 中。
  • 企业策略关闭了实验功能。
  • 浏览器版本、系统或驱动不支持 WebNN。

用控制台检测 WebNN

按 F12 打开开发者工具，在 Console 中运行：

async function checkWebNN() {
  if (!('ml' in navigator)) {
    return { enabled: false, reason: 'navigator.ml 不存在' };
  }

  for (const deviceType of ['npu', 'gpu', 'cpu']) {
    try {
      const context = await navigator.ml.createContext({ deviceType });
      context?.destroy?.();
      return { enabled: true, deviceType };
    } catch {
      // 继续检查下一个后端
    }
  }

  return { enabled: false, reason: 'API 存在，但无法创建执行上下文' };
}

checkWebNN().then(console.log);

也可以直接打开本站的 WebNN NPU 基准测试，查看浏览器暴露了哪些后端。

常见结果怎么处理

检测结果原因处理方法
navigator.ml 不存在浏览器未开放 WebNN、flag 未启用或页面不是安全上下文更新浏览器、启用 WebNN、改用 HTTPS
API 存在，但无法创建上下文驱动、硬件或浏览器后端不支持更新系统和驱动，尝试 Edge Beta/Canary
GPU 可用，NPU 不可用设备没有受支持的 NPU，或 NPU 后端仍处于预览可以继续使用 GPU，无需强制启用 NPU
工具仍显示 WASM页面在浏览器重启前已加载，或 WebNN 后端初始化失败完全重启浏览器并强制刷新页面
手机、macOS 或 Linux 搜不到开关平台支持范围不同使用最新版 Chromium 检查；没有开关时保留 WASM 回退

开启后仍会回退到 WASM 吗

会。模型可能包含当前 WebNN 后端不支持的算子，或者上下文创建失败。本站工具会优先尝试 WebNN；不可用时自动切换 WebGPU 或 WASM，避免功能完全失效。

WebNN 状态显示为 GPU 可用也算开启成功。只有明确需要低功耗 NPU 推理时，才需要继续排查 NPU。

官方资料