当你为一个新的网站规划页面时，迟早需要把页面地址分享给协作者，或者几个月后自己回查。一份简短的清单，记录每个页面的名称、完整地址和用途，能避免因引用不完整或含糊而产生的混乱。
一个假设的交接场景
假设你正在为一个社区项目规划一个小型文档站点。站点会有几个页面：一个着陆页、一个笔记区和一个参考页。你想把页面清单交给一位朋友帮忙补充内容。这是一个用于说明记录流程的假设场景，下面的地址并不指向真实已上线的页面。
如果没有结构化的记录，你可能会给朋友发一条消息说「笔记页在 example.org 的 /notes 下面某个地方」。这样的描述缺少协议方案、精确路径以及可能存在的查询或片段部分。朋友不得不猜测或追问才能找到正确的页面。一份清单通过为每个页面提供一致的完整条目来解决这个问题。
清单不需要是复杂的电子表格。一个纯文本文件或一张只有三列的简单表格——页面名称、完整地址和简短备注——对于少于十个页面的项目就足够了。关键习惯是每次都写下完整地址，而不是只写域名或只写路径。
清单上应该记录什么
URL（统一资源定位符）是互联网上唯一资源的地址，也是浏览器用来获取已发布资源（如 HTML 页面、图片和样式表）的关键机制之一。当你在清单上记录一个完整 URL 时，你记录的是浏览器访问该特定资源所需的精确地址。这与页面名称不同，页面名称只是你为自己参考而选择的一个便于人类阅读的标签。1
超链接将一个可见的文本字符串与一个 URL 关联起来，使用户能够从一个文档跳转到另一个文档。链接的可见文本与其目标 URL 是两个独立的信息。在你的清单上，页面名称大致对应读者看到的链接文本，而完整地址则是该链接背后的 URL。同时记录两者，可以让你确认可见标签与实际目标是否符合你的意图。2
第三列——备注——用于记录任何能帮助你或协作者理解页面作用的信息。你可以写「草稿，待审阅」或「链接到参考页」。这些备注是作者的观察记录，不是技术要求，存在的目的只是让交接更清晰，并提醒你地址本身无法传达的上下文。
阅读完整地址的各个部分
为了练习阅读完整地址，来看这个假设字符串 https://example.org/notes/first-page?view=compact#intro。这是一个为拆解各组成部分而构造的例子，并不声称该页面真实存在或已上线。方案是 https，表示浏览器请求资源时必须使用的协议。权限部分包含域名 example.org，表示正在请求哪台 Web 服务器。1
域名之后是路径 /notes/first-page，表示资源在 Web 服务器上的位置。问号引出查询字符串 view=compact，为 Web 服务器提供额外参数。井号引出片段 intro，它充当资源内部的书签。片段不会随请求发送到服务器，它只告诉浏览器在已加载的文档中滚动到哪个位置。1
在初次练习时，把每个部分单独写在一行上：方案一行，域名一行，然后依次是路径、查询和片段。这种将各组成部分隔离的习惯使你在后续更容易发现错误，比如路径段之间缺少斜杠或参数名拼写有误。你并不是在推断任何服务器的实际行为，只是在练习准确地阅读字符串。
为每个页面制作地址卡片
在清单中为每个页面记录一张卡片。每张卡片包含你选择的页面名称、完整 URL 以及一句关于页面用途的说明。以上述假设项目为例，一张卡片可以这样写：页面名称「笔记首页」，完整地址 https://example.org/notes/first-page?view=compact#intro，备注「笔记区的介绍部分，链接回着陆页」。
所有卡片使用一致的格式。如果你在一个地址中包含了协议方案，就在每个地址中都包含。如果你在一个地址中包含了片段，就决定片段对你的交接是否重要，并统一应用该决定。一致性意味着协作者永远不必猜测某个缺失的部分是有意省略还是疏忽遗漏。
备注列保持简短且客观。写页面包含什么内容或链接到哪里，而不是主观的质量评价。像「列出所有键盘快捷键」这样的备注在交接时比「不错的页面」更有用。目标是让下一个人有足够的上下文来定位和验证页面，而不必打开浏览器。
手工核对你的记录
将清单上的每个 URL 手工抄写到一行空白处，然后逐项标注各部分，这是最简单的核对方法。它能捕捉到你快速阅读时眼睛会跳过的拼写错误。这个过程很直接，只需要一个文本编辑器或一张纸。
检查方案和域名是否构成有效的权限格式：方案后面跟着分隔符 ://，再跟着域名。然后确认路径以正斜杠开头。如果地址包含查询，验证它以问号开头并使用键=值的格式。如果包含片段，验证它以井号开头。这些是 URL 结构参考中描述的组成规则。1
将你标注好的抄写副本与原始卡片条目逐字符对比。如果有任何字符不同，就修正卡片。在把清单发给协作者之前，对每个条目重复此过程。所花的时间相对于一个错误字符可能给使用者带来的困惑而言是微不足道的。
步骤 1
从清单卡片上将完整 URL 抄写到一行新的空白处。
步骤 2
标注各部分：标出方案、域名、路径以及任何查询或片段。1
步骤 3
将标注好的抄写副本与原始卡片条目对比，修正任何差异。
保留清单供日后使用
将清单文件保存在与项目内容相同的文件夹或仓库中。当你添加新页面时，同时添加一张新卡片，而不是等到工作结束时再补。这使记录保持最新，减少遗忘地址或其用途的可能性。
与协作者分享清单时，在文件顶部附上一行格式说明。写明有哪些列以及是否包含片段。这个小举动能让读者不必猜测你的约定，使交接自成一体。
随着时间推移，你可能会发现某些备注已过时或页面用途发生了变化。发生这种情况时更新备注列。清单是一份持续维护的记录，不是一次性的产物。它的价值在于有人阅读时它是准确的，而不在于它是原始计划的快照。
常见问题
清单上需要包含 URL 的片段部分吗？
如果片段指向对协作者任务有意义的特定章节，就包含它。片段不会发送到服务器，只影响浏览器在页面内的滚动位置，因此对某些交接来说它是可选的。如果你在一个条目中包含了片段，就在所有有片段的条目中一致地包含。1
页面名称和 URL 是同一回事吗？
不是。页面名称是你为自己参考而选择的人类可读标签，而 URL 是浏览器用来获取资源的机器可读地址。链接的可见文本与其目标 URL 是两个独立的信息，你的清单同时记录两者，使任何一方都不含糊。21
清单需要多少列？
三列对大多数小型项目来说足够：页面名称、完整地址和简短备注。如果多人同时更新页面，你可以增加一列状态，但核心信息就是名称、完整地址和简短的用途描述。