如何使用 URL Builder 从组件构造地址

先了解构造范围

URL Builder 用于把协议、主机、端口、路径、参数、查询字符串和片段组合起来，形成一个可供检查的地址文本，同时整理查询字符串中的参数信息。它适合在设计接口地址、比较不同组件组合或准备测试输入时使用；工具的作用是构造结果，不是访问该地址。使用时应把每个输入看成地址的一部分，分别确认其内容，再观察组合后的结果如何变化。

按顺序填写组件

1. 先选择协议，输入区域提供 https 和 http 两个选项；不作修改时，系统采用 https。
2. 再填写主机。主机未填写时采用 example.com；如果需要指定端口，可输入端口内容，并在结果中确认它是否被写入主机之后。
3. 设置路径。路径默认是根路径 /；如果输入内容没有以 / 开头，构造时会自动在前面补上这个字符，因此可以直接输入 api 来观察这一处理。
4. 根据需要填写参数和片段。参数与片段的默认内容都是空文本，查询字符串则预先提供 key=value&lang=en，你可以替换成要检查的查询内容。
5. 运行构造操作后，查看生成的地址文本和查询参数信息。建议一次只改动一个组件，例如先更换协议，再调整主机或路径，这样更容易判断结果中的变化来自哪项输入。
6. 若填写了端口，重点检查端口的数值转换结果；只有转换后大于零的整数才会出现在主机后面，其他情况不能按已指定端口来理解。

根据结果定位变化

阅读结果时，先核对协议、主机、端口和路径，再查看参数、查询字符串与片段是否出现在预期位置。完全不修改输入时，结果会采用 https 协议、example.com 主机和根路径，并带有 key=value 与 lang=en 这组查询内容；这能帮助你理解默认组件的组合方式。若只改动部分内容，应把注意力放在对应部分，而不要因为出现了组合文本，就认为输入已经通过有效性检查。查询字符串旁边的参数信息用于展示解析出的结构，不能据此判断地址能够被访问，也不能证明编码后再还原一定保持相同。遇到结果与预期不同的情况，可以恢复默认值，再逐项加入自定义组件，以缩小需要检查的范围。

使用示例

你正在为测试接口准备一个采用 http 协议、test.com 主机和 api 路径的地址文本。

将协议设为 http，主机填写 test.com，路径输入 api，然后运行构造操作，分别查看地址文本与查询参数结果。

结果中的地址文本包含 http 协议、test.com 主机和 api 路径，并提供查询字符串对应的结构化查询参数信息。

使用限制

• 构造结果和查询参数信息只用于查看组件组合及解析结果，不能用来确认地址可访问、输入有效，或编码往返后仍保持等价。

常见错误

• 如果把未带开头斜杠的路径当成会原样保留，结果中的路径可能看起来与输入不同；请按构造后的文本检查，工具会为这类路径补上开头的 /。

常见问题

默认输入会得到什么结果？

默认结果使用 https 协议、example.com 主机、端口 0 和根路径，参数与片段为空，并带有预设查询内容 key=value&lang=en。

什么情况下会显示端口？

当输入的端口转换为大于零的整数时，结果才会把它写在主机后面；例如输入 8080 时，可以看到主机后出现相应端口。

查询字符串会被解析吗？

输入的查询字符串会继续被解析，并以结构化查询参数信息呈现；这项展示不代表地址已经可以访问。