Go 的 path 包详解

Go 的 path 包处理路径字符串，管连接、拆分、解析这类操作，只认 Unix 风格的路径（以 / 分隔）。

此外，Go 还提供了 path/filepath 包，它是 path 包的一个扩展，用于处理平台特定的路径（包括 Windows 风格的路径，以 \ 分隔）。

1. path 包的功能

path 包主要提供以下功能：

• 路径连接：将多个路径元素合并为一个路径。
• 路径拆分：从路径中提取文件名或目录名。
• 路径规范化：将路径标准化为最简形式。

2. 函数详解

1. Join(elem ...string) string

   Join 函数将多个路径元素连接成一个路径，自动处理路径分隔符。

   package path
   
   func Join(elem ...string) string

   示例：

   package main
   
   import (
       "fmt"
       "path"
   )
   
   func main() {
       fullPath := path.Join("folder", "subfolder", "file.txt")
       fmt.Println("Full Path:", fullPath)
   }

   输出：

   Full Path: folder/subfolder/file.txt

   这个函数会自动在路径元素之间添加 /，并处理多余的分隔符。

2. Base(path string) string

   Base 函数返回路径中的最后一个元素，即文件名或目录名。

   package path
   
   func Base(path string) string

   示例：

   package main
   
   import (
       "fmt"
       "path"
   )
   
   func main() {
       baseName := path.Base("/folder/subfolder/file.txt")
       fmt.Println("Base Name:", baseName)
   }

   输出：

   Base Name: file.txt

   这个函数返回路径的最后一个部分，不包括路径分隔符之前的部分。

3. Dir(path string) string

   Dir 函数返回路径中的目录部分，即去掉最后一个路径元素后的部分。

   package path
   
   func Dir(path string) string

   示例：

   package main
   
   import (
       "fmt"
       "path"
   )
   
   func main() {
       dirName := path.Dir("/folder/subfolder/file.txt")
       fmt.Println("Directory Name:", dirName)
   }

   输出：

   Directory Name: /folder/subfolder

   这个函数从路径中去掉最后一个元素，返回剩余部分。

4. Split(path string) (string, string)

   Split 函数将路径拆分成目录和文件名两部分。

   package path
   
   func Split(path string) (dir, file string)

   示例：

   package main
   
   import (
       "fmt"
       "path"
   )
   
   func main() {
       dir, file := path.Split("/folder/subfolder/file.txt")
       fmt.Println("Directory:", dir)
       fmt.Println("File:", file)
   }

   输出：

   Directory: /folder/subfolder/
   File: file.txt

   这个函数将路径拆分为目录部分和文件名部分，其中目录部分包括最后的 /。

5. Clean(path string) string

   Clean 函数返回路径的规范化版本，消除多余的路径分隔符和上级目录引用（..）。

   package path
   
   func Clean(path string) string

   示例：

   package main
   
   import (
       "fmt"
       "path"
   )
   
   func main() {
       cleanPath := path.Clean("/folder/./subfolder/../file.txt")
       fmt.Println("Clean Path:", cleanPath)
   }

   输出：

   Clean Path: /folder/file.txt

   这个函数规范化路径，将 .（当前目录）和 ..（上级目录）转换为相应的路径。

6. IsAbs(path string) bool

   IsAbs 函数检查路径是否是绝对路径。

   package path
   
   func IsAbs(path string) bool

   示例：

   package main
   
   import (
       "fmt"
       "path"
   )
   
   func main() {
       fmt.Println("Is Absolute Path:", path.IsAbs("/folder/file.txt"))
       fmt.Println("Is Absolute Path:", path.IsAbs("folder/file.txt"))
   }

   输出：

   Is Absolute Path: true
   Is Absolute Path: false

   这个函数检查路径是否以根目录开始，在 Unix 风格的路径中以 / 开头的路径是绝对路径。

3. path 包与 path/filepath 包的区别

• path 包：处理 Unix 风格的 / 路径，规则与平台无关，不认识 Windows 的分隔符。
• path/filepath 包：按当前操作系统处理路径，Windows 的 \ 也支持。

示例：

package main

import (
    "fmt"
    "path/filepath"
)

func main() {
    // Join paths using filepath package
    fullPath := filepath.Join("folder", "subfolder", "file.txt")
    fmt.Println("Full Path:", fullPath)

    // Get base name and directory using filepath package
    baseName := filepath.Base("/folder/subfolder/file.txt")
    dirName := filepath.Dir("/folder/subfolder/file.txt")
    fmt.Println("Base Name:", baseName)
    fmt.Println("Directory Name:", dirName)

    // Clean path using filepath package
    cleanPath := filepath.Clean("/folder/./subfolder/../file.txt")
    fmt.Println("Clean Path:", cleanPath)

    // Check if path is absolute
    fmt.Println("Is Absolute Path:", filepath.IsAbs("/folder/file.txt"))
    fmt.Println("Is Absolute Path:", filepath.IsAbs("folder/file.txt"))
}

总结

path 包一共上面六个函数：Join 连接、Base 取文件名、Dir 取目录、Split 一拆二、Clean 规范化、IsAbs 判绝对路径，全部按 Unix 风格处理。路径里可能出现 \ 或盘符时，换 path/filepath。

参考资料

• io 标准库
• os 标准库
• path/filepath 标准库

同层页面

• Advanced
• CommonFormats
• EfficientIO
• ModOS
• Security

相关页面

• ModOS
• Security