页面链接交接清单：用假设项目记录页面名、完整地址和备注

当你为一个新网站规划页面时，迟早需要把每个页面的名称和完整地址记录下来，方便协作者或未来的自己再次找到它们。本文用一个假设地址演示一份简单的交接清单，展示如何阅读地址各部分、清晰地记录它们，并手工核对记录。

域名与完整地址分别告诉你什么

假设你正在规划一个小型项目网站，队友问笔记页面放在哪里。你可能只回答一个域名，比如example.org，但这只标明了服务器。域名提供的是互联网上某台网络服务器的人类可读地址，告诉你该联系哪台机器，而不是该机器上的哪个具体页面或文件。¹

完整的URL回答的是一个更具体的问题：那台服务器上的哪个资源？MDN解释说，URL是互联网上某个唯一资源的地址，也是浏览器用来获取已发布资源（如HTML页面、CSS文档和图片）的关键机制之一。当你把页面链接交给协作者时，完整URL告诉他们该打开哪个文档，而单独的域名只告诉他们该访问哪个站点。²

在我们的假设项目中，将使用地址 https://example.org/notes/first-page?view=compact#intro。这个地址纯粹为了演示而编造，并不指向真实页面。记住这一点有助于你把注意力放在字符串的结构上，而不必担心页面是否真的能加载。

阅读示例地址的各部分

我们来逐一标出 https://example.org/notes/first-page?view=compact#intro 的各个组成部分。方案是https，表示浏览器请求该资源时必须使用的协议。权限部分包含域名example.org，用于标识网络服务器。域名之后是路径/notes/first-page，指向该服务器上的某个具体资源。²

问号引出查询部分。在我们的例子中，view=compact是查询字符串，即一组为网络服务器提供额外参数的键值对。井号引出片段，这里是intro。MDN指出，片段相当于资源内部的一个书签，为浏览器指明应显示该书签位置的内容，并且井号后面的部分不会随请求发送给服务器。²

维基百科对URL语法的描述印证了这一层次结构：一个URI由方案、可选的权限、路径、由问号引导的可选查询以及由井号引导的可选片段组成。每个分隔符标记了各组成部分之间的边界。识别这些分隔符是在任何交接文档中准确记录地址的第一步。³

相同主机，不同路径与查询

现在保持主机部分example.org不变，想象同一项目的另外两个地址：https://example.org/notes/second-page 和 https://example.org/gallery/thumbnails?size=large。第一个共享相同的notes目录，但指向不同的页面文件。第二个转移到了完全不同的路径，并添加了一个关于显示尺寸的查询参数。

注意，改变路径就改变了你请求的资源，即使域名保持不变。改变查询字符串可能会改变服务器呈现该资源的方式，但我们无法假设服务器对view=compact或size=large实际做了什么，除非去询问管理服务器的人。字符串告诉我们请求的是什么；服务器决定如何响应。

这个区别对你的清单很重要。当你记录页面地址时，你记录的是字符串中写明的请求，而不是服务器将返回什么。如果队友后来问为什么页面看起来和你描述的不同，答案可能就在你没有写进笔记的查询参数或片段里。每次写下完整字符串就能消除这种模糊。

制作地址说明卡

为项目中的每个页面记录一张说明卡。每张卡片至少包含四个字段：你在日常交流中使用的简短页面名称、按你期望呈现的方式原样复制的完整地址字符串、用通俗语言说明该页面用途的备注，以及你撰写或最后核对该条目的日期。对于我们的假设笔记页面，卡片内容可以是：页面名称为「第一笔记页」，地址为 https://example.org/notes/first-page?view=compact#intro，用途是项目笔记本的起始页、以紧凑视图显示并滚动到引言部分，日期为你创建该条目的时间。

用自己的话写出用途，而不是照搬路径片段。像/notes/first-page这样的路径对开发者有意义，但未必能提醒内容编辑这个页面实际包含什么。一句「项目笔记本的起始页」能提供字符串本身不携带的上下文。如果页面的查询参数或片段会影响访客看到的内容，在用途备注中提及这个效果，避免日后有人感到意外。

保持卡片格式足够简单，让你确实愿意维护它。纯文本文件、电子表格中的一行或项目维基里的一条笔记都可以。重要的选择是一致性：一开始就选定一种格式，并对项目中的每个页面使用它。如果中途切换格式，你会花时间去调和两份列表，而不是继续建设站点。

手工核对说明卡

检查每张卡片的方法是：从源文档复制完整地址，粘贴到一个不会隐藏字符的纯文本编辑器中。然后逐一标注各部分：标出方案、域名、路径、查询和片段。将你的标注与卡片上的字段对比。如果任何部分缺失或拼写有误，先修正卡片再继续下一条。

进行第二轮确认：核对卡片上的页面名称是否与路径的最后一段或你项目所遵循的命名规则相匹配。在我们的例子中，路径以first-page结尾，卡片写的是「第一笔记页」。两者不必完全相同，但关系应该对任何阅读卡片的人一目了然，不需要打开浏览器。如果联系不明显，加一条简短说明解释为什么名称不同。

每次添加或修改页面地址时都重复这一核对。每张卡片只需一分钟，但它能抓住交接时造成混淆的小错误：一个漏掉的问号、一个未写入的片段、或一个把连字符误打成下划线的路径段。尽早养成习惯，清单就能在项目增长时保持可靠。

保留记录供日后使用

把完成的全套卡片存放在整个团队都能访问、而且你几个月后还能想起来的位置。共享文件夹、项目仓库或团队维基中的专门页面都是合理选择。具体工具不如习惯重要：每次需要查找或更新地址时都回到同一个地方。

当项目发生变化、页面移动或新增查询参数时，及时更新卡片而不是依赖记忆。一张写着旧日期「最后核对」的卡片是提醒你去重新验证的信号，而不是地址仍然有效的保证。把日期字段当作维护提醒，而不是认证。

最后，考虑在文件顶部加一段关于你自己记录选择的简短说明：你选了哪种格式、各字段含义是什么、以及任何约定，比如始终包含片段或始终写明方案。未来的协作者会感谢这份上下文，而你自己也会在休整后回到项目、需要回忆当初为什么这样组织卡片时感谢自己。

常见问题

记录页面地址时需要包含片段吗？

如果片段影响访客在页面上看到的内容，就把它包含进去，使你的记录与实际体验一致。如果页面有无片段时看起来一样，你可以注明它是可选的。无论哪种情况，写下你的决定，让下一个人知道省略是有意为之。

如果两个页面路径相同但查询参数不同，该怎么办？

把每个变体作为单独的卡片条目记录，写入包含查询在内的完整地址字符串。添加用途备注，说明每个参数改变了显示内容的什么方面。这样当队友复制一个地址却期望得到另一个版本时，就不会产生混淆。

卡片上可以用相对路径代替完整URL吗？

对于需要在站点外部阅读的交接清单，应写完整的绝对URL。相对路径只在已有基础地址的特定页面上下文中才有意义。完整字符串没有歧义，团队中的任何人都可以直接粘贴到浏览器地址栏中使用。