路径函数 on Hugo 中文文档

path.Base

Fri, 02 Oct 2026 00:00:00 +0800

{{ path.Base "a/news.html" }} → news.html
{{ path.Base "news.html" }} → news.html
{{ path.Base "a/b/c" }} → c
{{ path.Base "/x/y/z/" }} → z
{{ path.Base "" }} → .

path.BaseName

Fri, 02 Oct 2026 00:00:00 +0800

{{ path.BaseName "a/news.html" }} → news
{{ path.BaseName "news.html" }} → news
{{ path.BaseName "a/b/c" }} → c
{{ path.BaseName "/x/y/z/" }} → z
{{ path.BaseName "" }} → .

path.Clean

Fri, 02 Oct 2026 00:00:00 +0800

详见 Go 的 path.Clean 文档。

{{ path.Clean "foo/bar" }} → foo/bar
{{ path.Clean "/foo/bar" }} → /foo/bar
{{ path.Clean "/foo/bar/" }} → /foo/bar
{{ path.Clean "/foo//bar/" }} → /foo/bar
{{ path.Clean "/foo/./bar/" }} → /foo/bar
{{ path.Clean "/foo/../bar/" }} → /bar
{{ path.Clean "/../foo/../bar/" }} → /bar
{{ path.Clean "" }} → .

path.Dir

Fri, 02 Oct 2026 00:00:00 +0800

{{ path.Dir "a/news.html" }} → a
{{ path.Dir "news.html" }} → .
{{ path.Dir "a/b/c" }} → a/b
{{ path.Dir "/a/b/c" }} → /a/b
{{ path.Dir "/a/b/c/" }} → /a/b/c
{{ path.Dir "" }} → .

path.Ext

Fri, 02 Oct 2026 00:00:00 +0800

扩展名是路径中最后一个以斜杠分隔的元素里、从最后一个点开始的后缀；如果没有点，则为空字符串。

{{ path.Ext "a/b/c/news.html" }} → .html

path.Join

Fri, 02 Oct 2026 00:00:00 +0800

详见 Go 的 path.Join 与 path.Clean 文档。

{{ path.Join "partial" "news.html" }} → partial/news.html
{{ path.Join "partial/" "news.html" }} → partial/news.html
{{ path.Join "foo/bar" "baz" }} → foo/bar/baz
{{ path.Join "foo" "bar" "baz" }} → foo/bar/baz
{{ path.Join "foo" "" "baz" }} → foo/baz
{{ path.Join "foo" "." "baz" }} → foo/baz
{{ path.Join "foo" ".." "baz" }} → baz
{{ path.Join "/.." "foo" ".." "baz" }} → baz

path.Split

Fri, 02 Oct 2026 00:00:00 +0800

如果给定路径中没有斜杠，path.Split 返回的目录为空，文件名部分就是整条路径。两个返回值满足 path = dir+file。

{{ $dirFile := path.Split "a/news.html" }}
{{ $dirFile.Dir }} → a/
{{ $dirFile.File }} → news.html

{{ $dirFile := path.Split "news.html" }}
{{ $dirFile.Dir }} → "" (empty string)
{{ $dirFile.File }} → news.html

{{ $dirFile := path.Split "a/b/c" }}
{{ $dirFile.Dir }} → a/b/
{{ $dirFile.File }} → c