编写API交互代码时,Base URL末尾是否应添加斜杠?
REST API对接类Base URL的通用写法规范
行业内的通用偏好是Base URL不带末尾斜杠,也就是采用第二种写法:
private string baseUrl = "www.rest.com"; string url = this.baseUrl + "/item/delete";
选择这种写法的原因主要有三点:
- 避免重复斜杠问题:如果Base URL带末尾斜杠,拼接时若不小心给路由也加了开头斜杠,就会生成
www.rest.com//item/delete这类不符合URL规范的地址。虽然多数HTTP客户端会自动修复,但这种不严谨的写法可能引发潜在的解析问题。 - 语义更准确:Base URL代表的是API的根域名(或根资源节点),不带斜杠更贴合这个语义;斜杠作为路径层级的分隔符,放在路由开头能明确表示这是从根节点延伸的子路径。
- 契合主流工具约定:多数主流HTTP客户端、REST框架都默认推荐这种写法,统一的约定能减少团队协作时的拼接错误。
当然,核心原则是保持项目内写法一致,只要全团队统一遵循同一种规则,就能避免混乱。
内容的提问来源于stack exchange,提问作者TKoL
相关产品推荐
相关产品推荐

