网络分段命名规则：让文档结构更清晰

为什么命名规则很重要

写文档时，很多人只顾着把内容填进去，等回头要找某一段的时候，翻来覆去找不到。尤其在团队协作中，张三叫“用户登录流程”，李四写成“登录模块说明”，王五又弄个“login-process”。同一个东西三种叫法，沟通成本立马翻倍。

网络分段命名规则就是为了解决这个问题——给文档里的每个部分起一个统一、明确、能看懂的名字。

常见的命名混乱场景

比如你在写一份产品需求文档，里面涉及“注册”、“登录”、“找回密码”三个功能。如果标题写成：

• 开始页面操作
• 进入系统的方法
• 忘记怎么办

别人根本没法快速定位。换成清晰的命名：

<section id="user-registration">
  <h3>用户注册</h3>
</section>

<section id="user-login">
  <h3>用户登录</h3>
</section>

<section id="password-recovery">
  <h3>密码找回</h3>
</section>

结构一目了然，链接跳转也方便。

命名的基本原则

用英文小写加连字符是通用做法。比如 network-setup 比 NetworkSetup 或 network setup 更适合做ID或文件名。空格在URL里会变成%20，驼峰命名在HTML里也不如连字符直观。

长度要适中。太短说不清，太长又啰嗦。比如 api-config-for-payment-service 就比 config 明确，又不会像detailed-configuration-instructions-for-the-payment-api-module-v2那样拖沓。

结合文档排版的实际应用

在Markdown或HTML文档中，你可以这样组织：

<h2 id="overview">概述</h2>
<p>项目背景介绍……</p>

<h2 id="network-architecture">网络架构</h2>
<p>整体拓扑结构……</p>

<h3 id="segmentation-strategy">分段策略</h3>
<p>按业务划分VLAN……</p>

<h3 id="ip-addressing">IP地址规划</h3>
<p>子网分配表……</p>

这样一来，不仅目录清晰，别人引用时也能直接用链接定位到#segmentation-strategy这样的锚点。

如果是多人维护的文档，建议在开头加个命名对照表，约定好常用术语。比如：

时间久了，大家自然就统一了习惯。