为什么 example.com 总是出现在文档里？

写技术文章、代码示例或者教程的时候，你肯定用过 example.com 做占位域名。但你有没有想过，为什么偏偏是它，而不是随便挑一个域名来用？

拿真实域名举例的麻烦

假设你正在写一篇关于 DNS 设置的教程，直接把公司域名写进代码里。三个月后，有人从 Google 搜到这篇旧教程，原封不动地照着配置，结果你的域名突然收到一堆无关流量。更糟的是，有人配置错了邮件转发，你莫名其妙就收到了别人的邮件。

这种事情其实很常见，所以才需要「保留域名」。

IANA 保留的域名

IANA（互联网号码分配局）专门保留了一批域名，专门给文档、示例和测试用。这些域名永远不会被注册，也不会指向真实服务器。

最常用的几个保留域名有：

• example.com：文档里最常用的占位域名
• example.org：非商业示例常用
• example.net：另一个保留选项
• test.com：测试专用
• localhost：本地开发环境常用

为什么开发工作流里必须用它

不管你是做 AI 代码生成器、写云服务文档，还是给 NameOcean 的 Vibe Hosting 做教程，用保留域名都有几个明显好处：

安全又规范
example.com 能让读者一眼看出这是示例，不是真实配置。避免误用。

不会影响线上环境
真实域名会产生真实 DNS 查询，可能触发监控报警。保留域名完全不会。

大家都认识
开发者看到这些域名就知道是例子，不用额外解释。

避免法律和道德问题
不会把流量引到别人域名上，也不会引发知识产权纠纷。

实际用在哪些场景

API 接口文档

POST https://api.example.com/v1/users
Authorization: Bearer example_token_123
Content-Type: application/json

{
  "name": "Jane Developer",
  "email": "jane@example.com"
}

DNS 配置示例

A record: example.com → 192.0.2.1
CNAME: www.example.com → example.com
MX record: example.com → mail.example.com

SSL 证书演示
演示证书安装和续期时，用 example.com 做测试，完全不用担心影响真实域名。

AI 生成代码
如果训练数据里用了保留域名，AI 生成的代码也会更规范，不会造成运维问题。

文档其实也是产品的一部分

对 NameOcean 这种平台来说，文档质量直接影响用户体验。当开发者看到你用正确的保留域名做示例，他们从第一天起就养成了好习惯。

这在现在这个「快速原型 + AI 辅助」的时代尤其重要。好的文档能成为一道护栏，让开发者少走弯路。

写文档时的小建议

下次写博客、做代码示例或者教程的时候，直接把保留域名设为默认选项。这是个小决定，却能体现你的专业度。

文档不只教语法，更在教做事方法。从域名选择开始，就把标准立起来。

小贴士：把 IANA Special Use Domain Names 这页收藏起来。需要找安全域名做示例、测试或文档时，可以随时查。