MDN Web Docs（developer.mozilla.org）是 Mozilla 维护的 Web 平台技术文档库与学习资源：它系统收录 HTML、CSS、JavaScript、Web API、HTTP 等开放 Web 标准的参考条目和指南，绝大多数参考条目底部都附有一张跨浏览器兼容性表，这是它区别于一般教程站的核心特点。查阅全部内容免费、无需注册；内容本身开源托管在 GitHub 上，由 Mozilla、非营利组织 Open Web Docs 以及包括 Google、微软工程师在内的全球社区共同维护。根据官方 About 页（核查日期 2026-09-02），MDN 现有约 4.5 万页内容、月浏览量约 4600 万，提供简体中文和繁体中文在内的多语言界面。

MDN Web Docs 首页：Resources for Developers, by Developers，标注 Documenting CSS, HTML, and JavaScript, since 2005

上图是 MDN 首页：顶部导航按 HTML、CSS、JavaScript、Web APIs 等技术领域组织，Learn、Tools、Blog 为独立板块；首屏标语注明"Documenting CSS, HTML, and JavaScript, since 2005"，下方是精选文章与最新动态（截图时隐藏了页面广告位，广告情况见下文"局限"一节）。

站点速览

  • 网址：https://developer.mozilla.org/
  • 类型：Web 平台技术文档库与学习资源（开源协作维护）
  • 费用：文档与教程免费；可选付费订阅 MDN Plus（见下文）
  • 注册要求：查阅无需注册；编辑内容通过 GitHub 仓库提交 Pull Request；收藏、通知等个性化功能需 Mozilla 账号
  • 界面语言：英语为源语言；7 种活跃维护的人工翻译语言，含简体中文与繁体中文；德语、意大利语为机器翻译试验版本
  • 上线时间：2005 年
  • 运营方：Mozilla Corporation，与 Open Web Docs 及全球志愿者社区共同维护

站点背景

MDN 于 2005 年以 Mozilla Developer Center（代号 DevMo）之名上线，是一个社区驱动的 wiki，初始内容来自 Netscape 开发者站点 DevEdge——AOL 将这批文档授权给了 Mozilla 基金会使用。2010 年项目更名 Mozilla Developer Network（MDN），2017 年启用现名 MDN Web Docs 前后，微软、Google 和三星相继宣布关闭各自的 Web 文档项目、把文档统一到 MDN。（来源：MDN About 页、英文维基百科 MDN Web Docs 条目）

2020 年 12 月 14 日，MDN 从自建 wiki 平台（Kuma）迁移到静态化平台 Yari，全部文档改为 Markdown 存放在 GitHub 的 mdn/content 仓库，编辑流程变成标准的 Pull Request 评审。2021 年 1 月，非营利组织 Open Web Docs 成立，靠企业与个人捐款雇佣技术写作者专职维护 MDN 内容，目前是 MDN 最主要的贡献方之一。

此后 MDN 持续扩展形态：2022 年 3 月完成品牌改版并推出付费订阅 MDN Plus；2023–2024 年陆续上线代码演练场 Playground、AI 助手 AI Help、HTTP Observatory 安全检测、MDN Blog 和前端学习课程标准 MDN Curriculum；2025 年 8 月又上线了全新前端，用服务端渲染 HTML 加 Lit 组件替换了 2020 年以来的 React 单页应用，并优先选用达到 Baseline"广泛可用"级别的 Web 特性。2025 年 7 月，官方博客庆祝 MDN 上线 20 周年，当时全站已有近 1.4 万页英文文档、超过 3.3 万篇本地化文章和覆盖近 1.8 万个特性的兼容性数据。

内容体系与实用工具

MDN 的主体是参考文档：HTML 元素与属性、CSS 属性与规则、JavaScript 语言与标准库、数百个 Web API、HTTP 标头与方法等，条目通常包含语法说明、示例、规范链接和安全/可用性提示。条目页面顶部会标注 Baseline 状态（如"广泛可用"），帮助读者判断特性能否放心用于生产环境。

MDN 中文文档 Array.prototype.map() 条目：Baseline 徽标、可运行的交互示例与目录

上图是简体中文界面的 Array.prototype.map() 条目：绿色徽标标明该特性"基线 广泛可用"并列出主要浏览器图标，"尝试一下"区块内嵌可运行的交互示例，顶部提示说明该页面由社区从英文翻译而来——这也是 MDN 多语言内容的生产方式。

每个参考条目底部的浏览器兼容性表由独立的 browser-compat-data（BCD） 项目驱动，覆盖桌面与移动端主流浏览器及 Node.js、Deno 等运行时；Can I use 等第三方工具也使用这份数据。

MDN 条目的浏览器兼容性表：各浏览器支持版本一览

上图即 map() 条目的兼容性表：横向列出 Chrome、Edge、Firefox、Safari、各移动端浏览器与运行时，单元格中的数字是开始支持的版本，可点击展开更细粒度的子特性说明。

参考文档之外，MDN 还有一组配套板块：

  • Learn web development 与 MDN Curriculum：面向初学者的结构化学习路径。Curriculum 定义了前端开发者应掌握的技能清单，免费、自定进度，Learn 板块的核心教程即按此编排，并与 Scrimba 的付费互动课程衔接（Curriculum 页面，2025 年 10 月最后更新）。
  • Playground：在线代码演练场，可编写并运行 HTML/CSS/JS，登录后可分享。
  • HTTP Observatory：2024 年起并入 MDN 的网站安全头检测工具。
  • MDN Blog：2023 年 5 月开设，发布 Web 技术解读、教程与 MDN 公告。
  • AI Help：基于 OpenAI GPT-4o / GPT-4o mini 的问答助手，回答会引用 MDN 页面。

MDN Curriculum 页面：前端开发者必备技能体系，免费、自定进度

上图是 MDN Curriculum 页面：把前端技能分为入门、核心、扩展三组模块，Learn 板块教程与 Scrimba 合作课程都建立在这套体系上。

账号、订阅与开放能力

查阅文档完全不需要账号。注册免费的 Mozilla 账号后可以使用收藏集（Collections）、兼容性变更订阅（Updates）和 Playground 分享；在此基础上，MDN Plus 是面向重度用户的付费订阅，截至 2026-09-02 的官网档位为：Core 免费档（3 个收藏集、AI Help 每日 5 次提问）；MDN Plus 5 为 5 美元/月（免广告、无限收藏与 AI Help）；MDN Supporter 10 为 10 美元/月（另含新功能抢先体验），按年付费可减免两个月。根据 MDN Plus 服务条款，付费服务仅在美国、加拿大、英国、德国、法国、意大利、西班牙、比利时、奥地利、瑞士、荷兰、爱尔兰、马来西亚、新西兰和新加坡 15 个国家/地区提供（不含中国大陆和日本），且需要 Mozilla 账号。

对开发者更有价值的是它的开放能力：

  • 开源仓库：文档源文件在 mdn/content（截至 2026-09-02 有 10,964 个 Star、23,230 个 Fork），翻译在 mdn/translated-content，兼容性数据在 mdn/browser-compat-data，平台代码（yari、fred）同样公开，任何人都可以提 PR 修正文档。
  • 内容授权开放：文档以 CC BY-SA 发布、代码示例以 CC0 发布（详见下节），可以被合法引用、翻译和再加工。
  • MDN MCP server：2026 年 6 月推出的实验性 MCP 服务，把文档与兼容性数据直接接入 VS Code、Cursor、Claude Code 等 AI 工具，端点为 https://mcp.mdn.mozilla.net/。

版权与内容政策

MDN 的文档文字以 Creative Commons 署名-相同方式共享 2.5 或更高版本（CC BY-SA 2.5+） 授权，复用时需署名 "Mozilla Contributors" 并附原文链接、以相同条款发布衍生内容；2010 年 8 月 20 日之后添加的代码示例以 CC0（公有领域）发布，之前的为 MIT 许可。Mozilla 的商标、Logo 与网站外观设计不在 CC 授权范围内。向 MDN 贡献内容即同意按上述条款发布，官方明确不接受从其他来源直接抄袭的内容。

适用场景

  • 查 HTML 元素、CSS 属性、JavaScript API 的准确语法、参数与规范出处
  • 评估某个 Web 特性在目标浏览器中的支持程度（兼容性表 + Baseline 徽标）
  • 零基础系统学前端：Learn web development 教程与 Curriculum 技能体系
  • 中文读者以母语查阅文档（简/繁中文内容由志愿者维护）
  • 通过 CC 授权内容做翻译、教学材料或数据集；通过 MCP 把权威文档接入 AI 编程工具

局限

  • 页面有广告：未付费访客会看到横幅与侧栏广告（如首页与条目页的商业推广位），免广告是 MDN Plus 付费档的功能。
  • 翻译进度不均：非英语内容由志愿者社区维护，更新可能滞后于英文原文，部分冷门条目尚无翻译；自 2020 年底平台迁移后，维护力量不足的语言（如波兰语等）已被归档下线。
  • Plus 有地区限制：付费订阅仅在 15 个国家/地区提供，中国大陆不在其列。
  • AI 功能需谨慎：AI Help 的回答仍可能出错；MDN 2023 年上线的 AI Explain 功能就曾因质量不达预期被官方回滚并公开复盘。
  • 不提供一对一支持：MDN 团队明确表示无法回答代码调试类问题，这类问题应去 Stack Overflow 等社区。
  • 侧重开放 Web 标准：框架（React、Vue 等）内容相对有限，框架的官方文档仍是首选。

同类参考

  • web.dev：Google 维护的 Web 开发者资源站，偏重性能、体验最佳实践与课程，与 MDN 的中立参考定位互补。
  • Can I use：专注特性支持度查询的工具站，其数据即来自 MDN 的 browser-compat-data 项目。
  • W3Schools：商业运营的 Web 技术教程站，覆盖面相近，但编辑模式与内容授权条款与 MDN 不同。

参考资料