如何在Swift中递归复制目录并解析其中的所有符号链接（symlink）

Swift 标准库及 Foundation 框架中没有直接提供「递归复制目录且自动展开所有符号链接」的内置函数，但我们可以通过 FileManager 的目录枚举器配合配置项，用极少代码实现该需求，无需手动逐个判断、解析符号链接。

核心实现 #

我们可以对 FileManager 做扩展封装，利用目录枚举器的 followsSymbolicLinks 选项自动跟随符号链接，直接拿到实际指向的文件/目录内容：

import Foundation

extension FileManager {
    /// 递归复制目录，自动展开所有符号链接为实际内容
    /// - Parameters:
    ///   - sourceURL: 源目录路径
    ///   - destinationURL: 目标目录路径
    func copyItemResolvingSymlinks(at sourceURL: URL, to destinationURL: URL) throws {
        // 校验源路径存在性
        guard fileExists(atPath: sourceURL.path) else {
            throw NSError(domain: NSCocoaErrorDomain, code: NSFileReadNoSuchFileError, userInfo: [NSFilePathErrorKey: sourceURL.path])
        }
        // 初始化目录枚举器，自动跟随符号链接
        guard let enumerator = enumerator(
            at: sourceURL,
            includingPropertiesForKeys: [.isDirectoryKey],
            options: [.followsSymbolicLinks]
        ) else {
            throw NSError(domain: NSCocoaErrorDomain, code: NSFileReadUnknownError, userInfo: [NSFilePathErrorKey: sourceURL.path])
        }
        // 预先创建目标根目录
        try createDirectory(at: destinationURL, withIntermediateDirectories: true)
        let sourceRootPath = sourceURL.path as NSString
        
        // 遍历所有条目，枚举器已自动解析符号链接
        for case let itemURL as URL in enumerator {
            // 计算当前条目相对于源目录的相对路径
            let relativePath = sourceRootPath.relativePath(from: itemURL.deletingLastPathComponent().path)
            let targetItemURL = destinationURL
                .appendingPathComponent(relativePath)
                .appendingPathComponent(itemURL.lastPathComponent)
            
            let isDirectory = try itemURL.resourceValues(forKeys: [.isDirectoryKey]).isDirectory ?? false
            if isDirectory {
                // 目录直接创建
                try createDirectory(at: targetItemURL, withIntermediateDirectories: true)
            } else {
                // 文件直接复制，已自动跳过符号链接本身，复制实际内容
                if fileExists(atPath: targetItemURL.path) {
                    try removeItem(at: targetItemURL)
                }
                try copyItem(at: itemURL, to: targetItemURL)
            }
        }
    }
}

和默认的 copyItem(at:to:) 方法不同，该实现无需手动判断符号链接，枚举器会自动跟随所有符号链接，拿到其指向的实际文件/目录内容进行复制。

使用示例 #

let source = URL(fileURLWithPath: "/path/to/your/source/directory")
let target = URL(fileURLWithPath: "/path/to/your/target/directory")

do {
    try FileManager.default.copyItemResolvingSymlinks(at: source, to: target)
    print("复制完成，所有符号链接已展开为实际内容")
} catch {
    print("复制失败：\(error.localizedDescription)")
}

可选配置调整 #

你可以根据实际需求修改枚举器的 options 参数：

• 添加 .skipsHiddenFiles：跳过隐藏文件/目录的复制
• 添加 .skipsPackageDescendants：不遍历包类型目录的内部内容
• 若存在循环引用的符号链接，可以额外添加遍历层级限制，避免死循环

内容的提问来源于stack exchange，提问作者bjschoenfeld