保留域名到底在搞什么？example.com 为什么这么重要

写技术文档、做教程，或者跟团队演示 DNS 怎么工作的时候，你总会遇到一个问题：该拿什么域名来举例？用自己的域名吧，怕别人复制代码直接上线；用随便乱写的域名吧，又怕哪天真有人注册了。

这时候，保留域名就派上用场了。很多人没意识到，这些域名其实是故意留出来的。

什么是保留域名

ICANN 专门留了一些域名，只给文档和教学用。最常见的几个是：

• example.com
• example.org
• example.net

另外还有 example.edu、test.com、localhost.com 这些。它们不是被遗忘的域名，而是 ICANN 特意设定的，避免文档里的例子跑到真实环境里去。

为什么不能随便用真实域名

你写一篇关于 SSL 配置的教程，本来想用自己的域名举例。结果别人复制粘贴你的配置直接用在生产环境，那风险就大了。或者你发文的时候域名还没人用，发完之后被别人注册了，也挺尴尬的。

保留域名完全不用担心这些。它们永远不会指向任何人的真实服务器，用起来更安心。适合用在：

• 技术文档
• 代码示例和 GitHub 项目
• 教学视频
• API 文档
• 配置文件模板
• 白皮书演示

NameOcean 的实际经验

我们在 NameOcean 接触了很多开发者，他们在做文档的时候，最好的做法就是把保留域名当成版本控制一样，当成必须遵守的规范。

写域名设置、DNS 配置或者 SSL 安装的教程时，用 example.com 就能让读者马上明白：这只是教学内容，不是真的要你照着操作。这样就把「学习」和「生产」划清了界限。

跟现代开发怎么配合

保留域名跟现在的开发流程配合得很好：

Docker 和容器化：Dockerfile 里的例子用 example.com，CI/CD 跑起来不会因为网络查询失败而报错。

API 模拟测试：用 example.org 做 mock server，不会跟真实环境冲突。

基础设施即代码：Terraform、CloudFormation、Ansible 这些工具的示例配置，用保留域名更安全。

AI 辅助开发：如果你用 NameOcean 的 Vibe Hosting 搭配 AI 写代码，在提示词里加上保留域名，AI 生成的代码会更通用，不会意外指向真实服务器。

DNS 解析是怎么回事

很多人不知道，example.com 其实是能解析的。DNS 系统会正常返回记录，只是这些记录指向的是 IANA 维护的文档服务器，而不是生产环境。

你可以在终端试试：

dig example.com
nslookup example.org

你会看到正常的 DNS 响应，而不是 NXDOMAIN 错误。这不是 bug，是设计如此。

几个常见的错误

不要把保留域名用在生产代码里：虽然能解析，但它们不是用来跑真实业务的。监控面板会感谢你用真实域名。

不要以为它们永远不会变：虽然概率很小，但把保留域名当成永久固定在重要系统里，还是有风险。

不要把保留域名和真实域名混在一起：要么全用保留域名，要么全用真实域名，别让读者分不清哪个是真的。

最后说一句

AI 开发工具越来越强，清晰的文档就显得更重要。当你把例子丢给 NameOcean 的 Vibe Hosting 这种工具的时候，保留域名能帮助 AI 理解边界——什么该直接复制，什么需要自己改。

保留域名是个小细节，但它能让你的文档显得更专业。下一回写技术文档的时候，直接用 example.com 就对了。