URL 常用的路径处理方法

在 Swift 中，URL 类提供了多种方法，帮助我们对路径进行操作和管理。URL有很多常用的路径处理方法，以下是一些关键的方法和它们的作用：

操作路径方法

1、appending (_:)

appending 是一种更通用的 URL 拼接方法，可以直接将字符串添加到 URL 后。它不会检查或规范路径分隔符，因此如果用来拼接路径或文件名，可能会产生错误的路径结构。

使用场景

创建相对 URL：当构建网络 URL 或者路径需要相对拼接时。

追加查询参数：适合拼接 URL 查询参数或直接添加 URL 字符串。

// 用于网络请求 URL 拼接查询参数
let baseURL = URL(string: "https://example.com/api")!
let fullURL = baseURL.appending("endpoint")
// 结果: "https://example.com/apiendpoint" （这里不会自动处理分隔符）

// 直接拼接字符串，非路径
let urlString = "example.com/"
let finalURL = URL(string: urlString)!.appending("about")
// 结果可能会变成：example.com/about

2、appendingPathComponent(_:)

appendingPathComponent 用于在现有路径后添加新的路径组件，例如文件名或子目录。它可以确保路径的正确性，不会影响 URL 的其他部分。这个方法会自动处理路径的分隔符，确保生成的路径是有效的。

使用场景

拼接文件名或子目录：在现有目录路径后追加文件名或子文件夹。

构建文件系统路径：适用于本地文件系统路径的拼接。

// 拼接文件路径
let documentFileURL = URL.documentsDirectory.appendingPathComponent("example.txt")
// 结果示例: "file:///path/to/Documents/example.txt"

// 拼接子目录路径
let subdirectoryURL = URL.documentsDirectory.appendingPathComponent("Subfolder")

3、appendingPathExtension(_:)

作用：在 URL 后面添加文件扩展名。

let fileURL = URL.documentsDirectory.appendingPathComponent("example").appendingPathExtension("txt")

appendingPathExtension 是一种更结构化的方式，适合在需要动态更改文件扩展名或对路径进行更细化控制时使用。例如，在一个函数中可以轻松切换扩展名，而不用手动修改整个文件名字符串。

功能对比

从功能上看，appending(path:) 和 appendingPathComponent 的确有重叠之处，但它们设计上有一些微妙的区别，适合的场景稍有不同：

1、appendingPathComponent:

场景：逐步构建路径，通常用于添加单个文件或文件夹名称。

特点：自动添加路径分隔符，以确保每个部分都被正确添加。

灵活性：适合在构建路径时逐层增加目录，确保路径层级清晰和可控。

let documentsURL = URL.documentsDirectory
let fileURL = documentsURL.appendingPathComponent("folder").appendingPathComponent("example.txt")
print(fileURL) // Prints "/Documents/folder/example.txt"

2、appending(path:) (Swift 5.7 引入):

场景：直接附加更复杂或多层的路径片段，可以包含多个目录层级（如 “folder/subfolder/file.txt”）。

特点：同样自动添加路径分隔符，但更方便构建包含多个层级的路径。

灵活性：适合需要直接附加多层次路径的情况，减少逐步调用的麻烦。

let documentsURL = URL.documentsDirectory
let fileURL = documentsURL.appending(path: "folder/subfolder/example.txt")
print(fileURL) // Prints "/Documents/folder/subfolder/example.txt"

选择使用

逐步构建路径时：appendingPathComponent 更常见，更具语义性。

快速构建复杂路径时：appending(path:) 更加便捷。

所以，虽然它们在多数简单情况下确实可以互换，但 appending(path:) 更适合直接构建复杂路径，而 appendingPathComponent 则适合在路径构建过程中逐步添加层级。

管理路径方法

1、deletingLastPathComponent()

作用：删除 URL 的最后一个路径组件。

let directoryURL = fileURL.deletingLastPathComponent()

2、deletingPathExtension()

作用：删除 URL 的文件扩展名。

let baseURL = fileURL.deletingPathExtension()

3、standardized

作用：标准化 URL，解析相对路径（如 ../）。

let standardizedURL = fileURL.standardized

4、relativePath

作用：返回相对于应用沙盒的路径（如果是相对路径），或原样返回路径。

let relativePath = fileURL.relativePath

5、relativeString

用途：如果 URL 是相对路径，则返回相对字符串。

let relativeString = fileURL.relativeString

5、absoluteString

作用：以字符串形式返回 URL 的完整路径。

let urlString = fileURL.absoluteString

6、lastPathComponent

作用：获取 URL 的最后一个路径组件（例如文件名）。

let lastComponent = fileURL.lastPathComponent

7、pathExtension

作用：获取 URL 的文件扩展名。

let extension = fileURL.pathExtension

8、hasDirectoryPath

作用：返回 true 如果 URL 表示目录路径。

let isDirectory = fileURL.hasDirectoryPath

9、resolvingSymlinksInPath

用途：解析路径中的符号链接。

let resolvedURL = fileURL.resolvingSymlinksInPath()

10、standardizingPath

用途：标准化 URL 路径，解析 .. 和 . 等相对路径。

let standardizedURL = fileURL.standardizingPath