文档章节
路径函数
用这些函数处理文件路径。
这一章的函数处理的是路径字符串,不碰文件系统:拆分、取扩展名、拼接、规范化。它们统一按斜杠(/)理解路径,实测 Windows 反斜杠也会被换算成 /,所以同一段模板在三个平台上的输出一致。
需要提醒的是:这些函数的空输入行为不算直观(path.Base "" 返回 .、path.Dir "news.html" 返回 .),每页的「返回值边界(实测)」都单列了这些特例。
读完本章你应该能够
- 在
Base、BaseName、Ext、Dir、Split之间按需要选对函数,并说清哪些会保留扩展名、哪些不会; - 知道
path.Split的.Dir保留结尾斜杠、.File是尾段,因此Dir + File能还原原路径; - 用
path.Join拼接路径并理解它会顺带做规范化(含..、空段、重复斜杠); - 记住空输入与
nil的返回值(多为"."或""),避免页面上出现孤立的点; - 知道路径函数不拼
baseURL,生成站内地址还要再过urls系列。
建议阅读顺序
- path.Base —— 取尾段,最常用。
- path.BaseName —— 再去掉扩展名,注意
.gitignore这类隐藏文件的特例。 - path.Ext —— 只要扩展名(带点)。
- path.Dir —— 目录部分,注意无目录时返回
.。 - path.Split —— 一次拿到目录与文件名,比
Dir+Base更贴合原路径。 - path.Join / path.Clean —— 拼接与规范化,注意上游示例里有一行在 0.167 上不成立(本页实测已注明)。
本章内容
- path.Base 返回给定路径的最后一个元素;路径分隔符会先替换为斜杠(`/`)。 (今天)
- path.BaseName 返回给定路径的最后一个元素并去掉扩展名(如果有);路径分隔符会先替换为斜杠(`/`)。 (今天)
- path.Clean 返回与给定路径等价的最短路径名;路径分隔符会先替换为斜杠(`/`)。 (今天)
- path.Dir 返回给定路径中除最后一个元素以外的部分;路径分隔符会先替换为斜杠(`/`)。 (今天)
- path.Ext 返回给定路径的文件扩展名;路径分隔符会先替换为斜杠(`/`)。 (今天)
- path.Join 把给定的路径元素拼接为单个路径,返回与之等价的最短路径名;路径分隔符会先替换为斜杠(`/`)。 (今天)
- path.Split 返回给定路径的目录与文件名两部分,分割点在最后一个斜杠之后;路径分隔符会先替换为斜杠(`/`)。 (今天)