macOS Flutter应用重命名文件夹报错OS Error: Operation not permitted errno=1解决方法

• 检查沙箱权限配置
  Flutter macOS应用默认启用App Sandbox，即便手动授予了「完全磁盘访问权限」，沙箱规则仍可能限制直接访问硬编码路径的文件夹。

  • 打开项目的macos/Runner/DebugProfile.entitlements和macos/Runner/Release.entitlements文件，添加对应权限：
    • 如果是让用户手动选择文件夹后操作，添加com.apple.security.files.user-selected.read-write权限；
    • 若需直接访问Documents目录，可添加com.apple.security.files.downloads.read-write（Documents属于用户文档范畴），测试阶段也可临时启用com.apple.security.files.all（注意发布时需遵循苹果权限规范）。
  • 避免硬编码绝对路径，建议通过NSOpenPanel（可借助file_selector插件）让用户选择目标文件夹，沙箱会自动授予该路径的访问权限。

• 排查后台进程占用
  即使关闭了Xcode和Finder，仍可能有后台进程锁定父文件夹：

  • 打开终端，执行命令：

    lsof | grep "Documents/parent folder"
    

  • 查看输出中的PID列，找到占用文件夹的进程，用kill <PID>命令终止对应进程后再尝试重命名。常见的占用进程包括Xcode索引服务com.apple.dt.Xcode.IndexService、Git守护进程、第三方同步工具等。

• 重置文件夹权限与ACL
  父文件夹的权限或ACL设置可能存在异常：

  • 终端进入Documents目录，执行：

    ls -le "parent folder"
    

    检查输出中的ACL条目，若存在异常限制，可重置权限：

    chmod -R 755 "parent folder"
    chown -R $(whoami):staff "parent folder"
    

• 验证Flutter文件操作代码
  确保重命名逻辑没有路径解析或API使用问题：

  • 使用Directory.rename()方法时，确认新旧路径都是合法的绝对路径，处理带空格的路径时，直接用字符串即可，或通过Uri.file()构建路径避免解析错误：

    final parentDir = Directory(Uri.file('/Users/$(whoami)/Documents/parent folder').path);
    try {
      await parentDir.rename('/Users/$(whoami)/Documents/new-parent-folder');
    } catch (e) {
      print('重命名失败: $e');
    }
    

• 排除系统完整性保护（SIP）影响
  虽然Documents目录不在SIP保护范围内，但可临时验证：重启Mac到恢复模式，打开终端执行csrutil status，若SIP开启，可执行csrutil disable关闭后重启测试。测试完成后记得重新开启SIP（csrutil enable）。

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