Flutter macOS应用添加沙箱权限后无法重命名/移动文件

错误原因 #

你遇到的Operation not permitted错误，核心是macOS App Sandbox的权限限制：

• 当前App未被授予访问用户Documents目录的权限，直接硬编码路径访问该目录会被系统拦截。
• 沙箱环境中，App默认仅能访问自身容器内的目录（如代码中的/Users/xxx/Library/Containers/com.myapp.apps/Data/...），跨容器访问系统目录需要明确授权或用户主动确认。

解决方案 #

方案一：开启Documents目录访问权限 #

1. 打开Xcode，进入项目的Signing & Capabilities标签页
2. 在App Sandbox模块中，展开File Access选项
3. 找到Documents Folder，勾选Read/Write权限

开启后，原代码的rename操作即可正常执行，但需注意：提交App Store审核时，需明确说明该权限的使用用途。

方案二：通过用户选择获取目标路径（更符合沙箱规范） #

沙箱的设计逻辑是用户主动授权，硬编码路径访问系统目录可能在审核或特殊场景下出现问题，推荐通过文件保存对话框让用户选择目标位置：

步骤1：添加依赖

在pubspec.yaml中引入file_selector包：

dependencies:
  flutter:
    sdk: flutter
  file_selector: ^1.0.0

步骤2：修改代码

替换原有的文件移动逻辑：

import 'dart:io';
import 'package:file_selector/file_selector.dart';

void moveFile() async {
  String originalPath = '/Users/dhavalkansara/Library/Containers/com.myapp.apps/Data/Library/Caches/encryption-decryption/dummy copy 8.pdf.txt';
  File originalFile = File(originalPath);

  try {
    // 弹出保存对话框，让用户选择保存位置和文件名
    final XFile? savedFile = await getSaveLocation(
      suggestedName: 'dummy copy 8.pdf',
      allowedTypeGroups: [
        XTypeGroup(label: 'PDF文件', extensions: ['pdf']),
      ],
    );

    if (savedFile != null) {
      // 复制文件到目标位置后删除原文件（沙箱下跨目录rename可能受限）
      await originalFile.copy(savedFile.path);
      await originalFile.delete();
      print('文件移动成功');
    } else {
      print('用户取消了保存操作');
    }
  } catch (e) {
    print('错误：$e');
  }
}

这种方式通过用户主动选择路径获取授权，既符合系统安全规则，也能避免硬编码路径带来的兼容性问题。

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