macOS下使用Swift在下载文件夹创建目录遇权限异常问题

Hey there! Let's break down why you're hitting permission errors when trying to create that folder in the Downloads directory, and how to fix it step by step.

1. Check App Sandbox Permissions (Most Common Culprit for GUI Apps) #

If you're building a macOS app that uses App Sandbox (required for Mac App Store submissions, or if you've enabled it manually), your app doesn't have default access to the Downloads directory. Here's how to grant that access:

• Open your project in Xcode, go to the Signing & Capabilities tab for your target.
• If you don't see the App Sandbox capability, click the + Capability button and search for "App Sandbox" to add it.
• Scroll down to the File Access section, find Downloads Folder, and check the Read/Write box. This gives your app explicit permission to modify the Downloads directory.

2. Verify and Reset Downloads Directory Permissions #

Sometimes the Downloads directory itself has incorrect file system permissions. To check and fix this:

• Open Terminal and run this command to view current permissions:

  ls -ld ~/Downloads
  

  You should see output like drwx------+ your_username staff ... — this means your user account has full read/write/execute access.
• If permissions look off, run these commands to reset them to defaults:

  chmod 700 ~/Downloads
  chown $USER:staff ~/Downloads
  

3. Debug the Exact Error #

Your code cuts off in the catch block — expanding it to print detailed error info will help you pinpoint the root cause. Update your function like this:

static func createFolderInDownloadsDirectory() {
    guard let downloadsDirectory = FileManager.default.urls(for: .downloadsDirectory, in: .userDomainMask).first else {
        print("Failed to locate the Downloads directory")
        return
    }
    let folderURL = downloadsDirectory.appendingPathComponent("FolderToCreate")
    
    do {
        try FileManager.default.createDirectory(at: folderURL, withIntermediateDirectories: true, attributes: nil)
        print("Successfully created folder at: \(folderURL.path)")
    } catch {
        print("Error creating folder: \(error.localizedDescription)")
        // Get more detailed POSIX error context
        if let nsError = error as NSError? {
            print("Detailed error code: \(nsError.code), details: \(nsError.userInfo)")
        }
    }
}

Running this will show you exactly what's causing the failure (e.g., sandbox restriction vs. file system permission mismatch).

4. For Command Line Tools #

If you're building a command line tool, App Sandbox isn't enabled by default, so the issue is almost certainly file system permissions. Follow step 2 to reset your Downloads directory permissions, and make sure you're running the tool as your regular user account (not root, which can cause permission mismatches).

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