documentation

MDN Web Docs

所属分类:开发教程

查阅 HTML、CSS、JavaScript 与 Web API 的开发文档

MDN Web Docs 是面向 Web 开发者的开放技术文档站,围绕 HTML、CSS、JavaScript、Web API 等浏览器技术整理入门学习材料、概念指南和参考条目。初学者可以沿着主题逐步学习,已有经验的开发者也可以直接查找某个属性、方法或接口。

MDN Web Docs:面向 Web 开发者的技术文档

发布于 2026年10月2日更新于 2026年10月27日

MDN Web Docs 中文首页与技术主题导航

从首页进入不同技术主题

首页导航把常用内容分为 HTML、CSS、JavaScript 和 Web APIs 等入口,也提供 Learn、Tools、About 等栏目。中文首页介绍了 MDN 对 CSS、HTML 和 JavaScript 的长期文档维护,用户可以先选技术方向,再从教程、指南或参考材料继续深入。进入具体主题后,面包屑和左侧目录保留上下文,便于在相邻概念之间切换,而不是每次都回到首页重新搜索。

MDN 的目录同时服务不同阶段的学习。刚接触浏览器开发的人可以从基础课程与概念指南开始,遇到具体语法问题时则进入参考文档。比如 CSS 区域既有布局指南,也有属性级条目;JavaScript 区域把语言指南与全局对象、内置方法等参考内容分开。这样的组织方式让概览和细节互相连接,读者可以先建立概念,再查精确行为。

参考条目适合解决具体问题

MDN 的参考页通常会说明功能定义、语法、参数、返回值和使用场景,并提供示例、规范来源及浏览器兼容信息。以 JavaScript 的 Array.prototype.map() 页面为例,页面说明它会对数组元素逐一调用回调并生成新数组,随后提供语法、示例和兼容性栏目。读者可以从摘要开始,按目录跳到需要的部分,再查看关联方法或更完整的 JavaScript 指南。

Array.prototype.map() 参考页的说明、代码示例和兼容状态

页面中的示例覆盖的不只是最简单的数字转换,还讨论对象数组、稀疏数组、NodeList 等使用情境。学习者可以对照示例理解回调参数与返回值;排查实际项目问题时,则可查看规范和浏览器支持信息,避免把某个浏览器的表现误认为语言在所有环境中的统一行为。参考页适合作为编码时的查阅依据,不代替在目标浏览器和项目环境中的实际测试。

用站内搜索定位名称与近似条目

MDN 首页和文档页都提供站内搜索。输入 Array.prototype.map 后,搜索面板会给出对应的 JavaScript 参考页,也会列出 flatMap()、TypedArray.prototype.map() 等相近条目,并标明各自的目录路径。这个提示有助于区分名称相似但作用对象不同的 API;从结果进入页面后,左侧导航仍可浏览同一主题中的其他属性和方法。

搜索 Array.prototype.map 后显示的相关参考条目

搜索适合已经知道术语的用户;若还不清楚应搜索什么,可以先从首页主题或 Learn 教程入手。文档页也保留标题层级、面包屑和“本文内容”目录。页面较长时,目录可以帮助读者快速跳到参数、示例或浏览器兼容部分;逐级展开左侧目录则适合系统阅读一个技术主题。

阅读参考页时核对上下文

遇到问题时,先辨认要查的是哪一层:HTML 元素、CSS 属性、JavaScript 方法,还是浏览器接口。搜索结果会给出目录路径;进入条目后先读定义,再核对语法、参数和返回值,确认说明对应的对象。若问题来自页面布局,可以从指南按概念阅读;若代码依赖具体浏览器能力,再看兼容表和规范链接。简体中文页出现翻译提示时,可以对照英文原文中的术语和段落。这样能把“找一个能用的片段”转变为核对 API 行为和支持范围,帮助判断资料是否适用于当前项目。

通过指南理解 Web 平台概念

指南把多个属性、概念和使用情境串起来。CSS 弹性盒子布局的基本概念页从主轴与交叉轴开始,再说明容器、换行、元素尺寸和对齐等主题。页面目录展示了章节结构,正文用文字、代码和示意内容逐步解释布局行为,并链接到更细的属性参考。读者可以把指南当作概念地图,再按需深入 flex-direction、flex-wrap、align-items 等条目。

CSS Flexbox 指南展示主轴、交叉轴和相关章节目录

HTML 内容也以类似方式组织:既有元素和属性参考,也有表单、语义结构和页面基础等学习指南。Web APIs 部分则面向浏览器提供的接口,例如文档对象、网络请求、存储、媒体和设备能力。不同主题的资料深度并不完全相同,部分页面先以英文编写或翻译自英文;遇到翻译说明时,可以切换英文原文对照术语和更新内容。

示例、规范与兼容数据如何配合

MDN 条目会链接相关 Web 标准或规范,帮助读者了解功能对应的标准来源。浏览器兼容区域按浏览器和版本展示支持状态,读者能据此初步判断某个特性是否适合目标用户。兼容信息尤其适用于 CSS 新属性、较新的 JavaScript 能力和 Web API;检查时应同时留意页面标注的状态、具体版本和已知限制。

规范链接、兼容表和示例的用途不同:规范描述标准要求,兼容数据总结浏览器实现情况,示例则帮助理解常见写法。把三者放在一起查阅,可以避免只凭单个代码片段推断边界行为。MDN 还会在页面中加入相关链接,让读者从一个接口继续找到替代方法、配套事件或更完整的学习路径。

学习材料、社区与维护方式

MDN Learn 提供面向入门者的学习材料和结构化课程;MDN 社区也欢迎参与文档编写、翻译及兼容数据改进。About 页面说明,项目由 Mozilla 维护,并与全球志愿者和合作伙伴共同建设。页面底部标明文档内容依据 Creative Commons 许可提供;代码示例、商标和各类媒体仍应按对应页面或仓库的许可说明分别核对。

普通文档阅读不要求先登录。登录入口主要与账户功能和贡献流程相关。MDN Plus 是额外服务,官方介绍页列出收藏集合、更新筛选、Playground 分享和 AI 帮助等功能;页面同时提供名为 Core 的免费方案,其中部分功能有数量或每日使用限制。是否需要账户取决于是否使用这些增强功能,阅读公开参考资料可以直接从文档页面开始。

适用场景与使用边界

MDN 适合前端开发者、Web 平台学习者、课程教师和需要核对浏览器行为的工程团队。新手可以按 HTML、CSS、JavaScript 的主题学习基础;有经验的开发者可以把它作为查阅语法、参数、兼容情况和规范链接的参考。它是综合文档库,不是在线托管项目的开发环境;虽然 MDN Plus 包含 Playground 等扩展能力,核心价值仍在公开文档与学习材料。

中文内容覆盖常见主题,但术语翻译和更新进度可能因页面而异。对于重要的兼容性决策,建议结合目标浏览器版本、正式规范和项目测试结果判断;对于账户、订阅和增强功能,则直接查看 MDN Plus 当前页面的方案说明。总体来说,MDN 将入门阅读、概念解释与精确参考放在同一站点,既能从知识主题出发,也能从一个具体 API 名称快速定位。