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

规划一个小型网站时，你很快会积累一份需要命名、记录地址和简短说明的页面列表。从一开始就整理好这些信息，无论是交给协作者还是中断后重新接手，都能减少混乱。本文通过一个明确的假设示例，演示如何阅读和记录一条完整的网页地址，并把它整理成可交接的说明卡。

域名与完整URL分别回答什么问题

假设你正在构思一个小型个人项目站点，包含首页、笔记区和相册等几个页面。在这些页面真正上线之前，你想先把每个页面的位置写下来，以便清晰地传达规划。首先要厘清的问题是域名与完整URL的区别，因为它们回答的是不同的问题。域名标识的是整台网络服务器或整个站点。MDN的解释是，域名为互联网上任何可用的网络服务器提供了一个人类可读的地址，解决了原始IP地址难以记忆且可能随时间变化的问题。¹

完整URL则指向该服务器上的某一个具体资源。MDN将URL定义为互联网上唯一资源的地址，并指出它是浏览器用来获取已发布资源（如HTML页面、CSS文档和图片等）的关键机制之一。因此，当你在项目规划中为某个特定页面记录地址时，你写下的是完整URL，而不仅仅是域名。域名告诉你这是哪个站点；完整URL告诉你这是该站点上的哪个页面。²

本文余下的部分将围绕同一条假设地址展开：https://example.org/notes/first-page?view=compact#intro。这条字符串纯粹是为了拆解练习而构造的，并不声称该页面真实存在或曾经上线。请把它当作一个可以反复标注和重新标记的样本，借此练习为自己的未来项目准确记录地址的习惯。

在本例中标出各组成部分

把完整字符串 https://example.org/notes/first-page?view=compact#intro 写在一行空白处，然后逐段标记。开头的 https 是方案（scheme）。MDN说明方案指示浏览器请求资源时必须使用的协议，对于网站来说通常的选择是HTTPS或HTTP。在本例中，https告诉浏览器使用安全版本的协议。²

下一个片段 example.org 是域名，也称主机部分。它位于 :// 分隔符与路径的第一个正斜杠之间。MDN将域名描述为指示正在请求哪台网络服务器。在权威部分之后、第一个斜杠之前的所有内容都属于这个主机部分。在我们的假设字符串中，example.org就是站点级别的标识符。²

主机之后是路径：/notes/first-page。MDN解释说路径表示资源在网络服务器上的位置，不过在现代实践中它主要是由服务器处理的抽象，而非字面上的文件位置。路径之后，问号引入查询字符串：view=compact。MDN将参数描述为提供给网络服务器的额外键值对，多个键值对之间用&符号分隔，这里只有一个键值对。最后，井号引入片段标识符：intro。MDN指出片段相当于资源内部的书签，并且片段部分永远不会随请求发送到服务器。因此问号标志着查询的开始，井号标志着片段的开始。²

保持主机不变，对比不同路径和查询字符串

现在保持主机部分 example.org 完全不变，只改变路径。如果把 /notes/first-page 替换为 /gallery/summer-shots，得到的字符串 https://example.org/gallery/summer-shots 就指向站点结构中一个不同的位置。方案、主机和协议完全相同，只有路径不同。这个观察纯粹针对字符串本身。我们并不声称服务器会对这两个地址返回什么内容，因为服务器行为取决于我们尚未指定的配置。

接下来，保持主机和路径都不变，只改变查询字符串。把 view=compact 替换为 view=full，得到 https://example.org/notes/first-page?view=full。路径相同，所以字符串仍然指向同一个名义位置，但查询现在携带了不同的参数值。同样，这是关于字符串如何组装的结构性观察。真实服务器是否会对 view=full 和 view=compact 做出不同响应，是那个服务器实现层面的问题，仅凭URL语法无法判断。

你也可以完全去掉片段。删除末尾的 #intro 后得到 https://example.org/notes/first-page?view=compact。片段是客户端书签，去掉它只会改变浏览器在页面内可能滚动到的位置，并不会改变向服务器请求的资源。注意这些区别有助于你在项目文档中准确描述每个部分的作用，而不会对幕后发生的事情做过度的断言。

为假设项目制作一张地址说明卡

为你规划的每个页面记录一张简短的说明卡。对于我们的假设示例，卡片可以包含三个字段。第一个是目的说明：该页面旨在作为个人笔记项目中第一条笔记的紧凑阅读视图。第二个是完整地址字符串的精确抄写：https://example.org/notes/first-page?view=compact#intro。第三个是逐部分拆解，列出方案、主机、路径、查询和片段各自的值。把这三个字段放在一起，任何阅读你笔记的人都能同时理解地址的意图和机械结构，无需猜测。

在目的字段中使用平实的语言。像「第一条笔记的紧凑阅读视图」这样的短语，比「页面一」这种模糊标签对未来的读者更有用。目的字段是你自己的编辑选择，并非任何技术标准的规定。你只是在创建一个与机器可读地址配对的人类可读摘要。如果项目增长，这些目的说明就变成了一个可以快速浏览的索引，无需打开浏览器。

决定是否在卡片中包含片段。由于片段是服务器永远不会接收的客户端书签，有些项目团队会把它与主地址分开记录，或者标记为可选。在这个假设练习中，我们把它包含在完整字符串里，但加一条简短备注说明它控制的是滚动位置而非服务器内容。这样你的记录就如实反映了每个部分的实际作用，也避免了协作者疑惑为什么去掉片段后页面仍然正常。

用手工复制与逐项标记核对说明卡

检查你的说明卡是否与原始字符串一致，方法是把地址逐字符复制到一个新的文本栏中。不要依赖记忆或自动更正。把复制的版本放在卡片旁边并排对比。哪怕一个斜杠放错位置或者少了一个问号，都会改变字符串的含义，所以这个机械对比步骤值得花几秒钟完成。

标注新复制字符串中每个片段的角色：在 https 上方写「方案」，在 example.org 上方写「主机」，在 /notes/first-page 上方写「路径」，在 view=compact 上方写「查询」，在 intro 上方写「片段」。然后把你的标注与卡片上的拆解字段对比。如果任何标注与你最初记录的内容不一致，先修正卡片再继续。这一步是作者推荐的习惯，并非任何工具或标准的强制要求。

对比较步骤中记录的任何变体地址重复同样的标注流程。例如，如果你还记录了 https://example.org/gallery/summer-shots 作为第二个假设页面，就给它也做一张卡片并执行同样的复制与标注检查。尽早建立这个节奏，意味着当项目扩展到两三个页面以上时，你已经有一套可靠的常规流程来发现拼写错误和标注错误，避免它们在交接文档中造成混乱。

保留这份说明供以后写作或沟通使用

把完成的说明卡存放在一个方便分享或回顾的格式中。纯文本文件、简单的电子表格或项目管理工具中的笔记都可以。重要的选择是一致性：选定一个位置，把所有地址说明卡都放在那里，这样当协作者询问某个特定页面的链接时，你不必在多个文件之间翻找。格式本身不如回到同一个地方的习惯重要。

当你交接项目或引入新的贡献者时，说明卡为对方提供了一个超越单纯URL列表的起点。目的字段解释了意图，完整地址给出了精确字符串，标注拆解展示了每个部分的作用。这对刚接触URL结构的人尤其有帮助，因为他们一眼就能看到查询从哪里开始、为什么片段是可选的。你实际上是在把自己的理解打包成一份可复用的参考资料。

最后，把这份记录当作一份活文档来对待。如果你后来决定重命名某个路径片段或去掉一个查询参数，同时更新对应的说明卡。这份清单的价值不在于一次性创建它，而在于随着项目演进持续维护它。即使只是一个小小的习惯——让卡片与实际变更保持同步——也能让交接文档保持可信，避免所有人都在使用过时的地址。

常见问题

交接文档中记录页面地址时，需要包含片段部分吗？

这取决于片段对你的读者是否有用。由于片段是服务器永远不会接收的客户端书签，你可以单独记录它或标记为可选。把它包含在内并附上关于其角色的简短备注，既保持了记录的完整性，也不会造成混淆。

URL中查询字符串和路径有什么区别？

路径标识资源在服务器上的名义位置，而查询字符串携带服务器可能用来修改响应的额外键值参数。路径紧跟在主机之后、问号之前；查询从问号开始，一直持续到井号或字符串末尾。²

同一套说明卡格式可以用于不同域名下的页面吗？

可以。这里描述的卡片格式是通用的。每张卡片记录目的、完整地址和逐部分拆解，无论地址属于哪个域名。你只需在主机字段中填入相应页面的域名即可。