沙盒化macOS SwiftUI应用读取.ssh/config文件报错如何解决？

核心原因 #

你遇到的报错有两个核心诱因：

• 路径构造逻辑错误：通过桌面路径字符串替换的方式获取.ssh/config路径可靠性极低，同时沙盒环境下默认获取的用户目录是应用专属的容器目录（即报错中的/Users/name/Library/Containers/sa.GitRepository/Data/），而非用户真实的主目录，容器内默认不存在.ssh/config文件
• 沙盒权限限制：默认开启沙盒的macOS应用没有权限直接读取用户主目录下的~/.ssh目录，触发系统权限拦截也会返回文件不存在的错误

修复步骤 #

1. 修正路径构造逻辑 #

不要使用字符串替换的方式拼接路径，改用FileManager官方API构造路径，避免因系统语言、用户自定义目录位置导致的路径错误：

// 获取用户真实主目录（需先配置沙盒权限才能获取到真实路径）
let homeDir = FileManager.default.homeDirectoryForCurrentUser
let configURL = homeDir.appendingPathComponent(".ssh/config")

2. 配置沙盒访问权限 #

打开Xcode项目，进入对应应用Target的「Signing & Capabilities」标签，在「App Sandbox」配置段根据应用发布场景选择对应权限：

• 若应用需要上架Mac App Store：
  • 勾选「File Access」分类下的「User Selected File」，权限设置为「Read Only」
  • 后续访问文件前需要先弹出NSOpenPanel让用户手动选择~/.ssh/config文件完成授权，拿到授权URL后调用url.startAccessingSecurityScopedResource()获取访问权限，访问结束调用url.stopAccessingSecurityScopedResource()释放权限即可。需要跨启动仍可访问的话可以将URL存储为安全范围书签持久化。
• 若应用不需要上架App Store，走独立分发渠道：
  • 直接勾选「File Access」分类下的「Home Directory」，权限设置为「Read Only」，即可直接访问用户主目录下的.ssh/config文件，无需用户手动授权。

3. 修复后完整代码示例 #

let configURL = FileManager.default.homeDirectoryForCurrentUser.appendingPathComponent(".ssh/config")
do {
    let contents = try String(contentsOf: configURL, encoding: .utf8)
    let myStrings = contents.components(separatedBy: .newlines)
    let users = myStrings.filter { $0.contains("github.com-") }.map {
        $0.replacingOccurrences(of: "Host github.com-", with: "")
    }
    if !users.isEmpty {
        _user = State(initialValue: users[0])
    }
    _userArray = State(initialValue: users)
} catch {
    print("Ooops! Something went wrong: \(error)")
}

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