文档章节

路径函数

用这些函数处理文件路径。

这一章的函数处理的是路径字符串,不碰文件系统:拆分、取扩展名、拼接、规范化。它们统一按斜杠(/)理解路径,实测 Windows 反斜杠也会被换算成 /,所以同一段模板在三个平台上的输出一致。

需要提醒的是:这些函数的空输入行为不算直观(path.Base "" 返回 .、path.Dir "news.html" 返回 .),每页的「返回值边界(实测)」都单列了这些特例。

读完本章你应该能够

  • 在 Base、BaseName、Ext、Dir、Split 之间按需要选对函数,并说清哪些会保留扩展名、哪些不会;
  • 知道 path.Split 的 .Dir 保留结尾斜杠、.File 是尾段,因此 Dir + File 能还原原路径;
  • 用 path.Join 拼接路径并理解它会顺带做规范化(含 ..、空段、重复斜杠);
  • 记住空输入与 nil 的返回值(多为 "." 或 ""),避免页面上出现孤立的点;
  • 知道路径函数不拼 baseURL,生成站内地址还要再过 urls 系列。

建议阅读顺序

  1. path.Base —— 取尾段,最常用。
  2. path.BaseName —— 再去掉扩展名,注意 .gitignore 这类隐藏文件的特例。
  3. path.Ext —— 只要扩展名(带点)。
  4. path.Dir —— 目录部分,注意无目录时返回 .。
  5. path.Split —— 一次拿到目录与文件名,比 Dir + Base 更贴合原路径。
  6. path.Join / path.Clean —— 拼接与规范化,注意上游示例里有一行在 0.167 上不成立(本页实测已注明)。

本章内容

  • path.Base 返回给定路径的最后一个元素;路径分隔符会先替换为斜杠(`/`)。 (今天)
  • path.BaseName 返回给定路径的最后一个元素并去掉扩展名(如果有);路径分隔符会先替换为斜杠(`/`)。 (今天)
  • path.Clean 返回与给定路径等价的最短路径名;路径分隔符会先替换为斜杠(`/`)。 (今天)
  • path.Dir 返回给定路径中除最后一个元素以外的部分;路径分隔符会先替换为斜杠(`/`)。 (今天)
  • path.Ext 返回给定路径的文件扩展名;路径分隔符会先替换为斜杠(`/`)。 (今天)
  • path.Join 把给定的路径元素拼接为单个路径,返回与之等价的最短路径名;路径分隔符会先替换为斜杠(`/`)。 (今天)
  • path.Split 返回给定路径的目录与文件名两部分,分割点在最后一个斜杠之后;路径分隔符会先替换为斜杠(`/`)。 (今天)