Android应用中如何重命名外部SD卡上的文件夹？

这个问题我之前也碰到过，核心原因是Android对真实外部SD卡的权限限制和内部存储完全不同：你提到的Environment.getExternalStorageDirectory()指向的是内置的“外部存储”（其实是手机自带的扩展存储），而你插的物理SD卡属于“二级外部存储”，从Android 4.4开始，第三方APP就不能直接通过传统的File类方法（比如renameTo()）对其进行修改了，哪怕你加了WRITE_EXTERNAL_STORAGE权限也不行。

正确的解决方案：使用Storage Access Framework（SAF） #

SAF是Android官方提供的用于访问外部存储（包括物理SD卡）的框架，它需要用户主动授权APP访问目标目录，之后就能通过系统提供的API进行重命名操作。下面是具体步骤和代码示例：

1. 启动目录选择器，获取用户授权

首先需要让用户选择你要操作的SD卡目录（或者整个SD卡），通过Intent.ACTION_OPEN_DOCUMENT_TREE来唤起系统的文件选择器：

private static final int REQUEST_CODE_SD_DIR = 1;

private void requestSdCardAccess() {
    Intent dirPickerIntent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE);
    // 添加权限标记，确保获得读写权限
    dirPickerIntent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
    dirPickerIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
    // 持久化权限，避免APP重启后需要重新授权
    dirPickerIntent.addFlags(Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION);
    startActivityForResult(dirPickerIntent, REQUEST_CODE_SD_DIR);
}

2. 处理授权结果，执行重命名

在onActivityResult中接收用户选择的目录Uri，然后用DocumentFile来完成重命名操作：

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == REQUEST_CODE_SD_DIR && resultCode == RESULT_OK && data != null) {
        Uri sdTreeUri = data.getData();
        if (sdTreeUri == null) return;
        
        // 持久化权限，确保下次启动APP仍能访问该目录
        getContentResolver().takePersistableUriPermission(
                sdTreeUri,
                Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION
        );
        
        // 调用重命名方法，示例：将SD卡下的"OldFolder"改成"NewFolder"
        renameFolderWithSAF(getContentResolver(), sdTreeUri, "OldFolder", "NewFolder");
    }
}

private void renameFolderWithSAF(ContentResolver resolver, Uri parentDirUri, String oldFolderName, String newFolderName) {
    // 从Uri获取父目录的DocumentFile实例
    DocumentFile parentDoc = DocumentFile.fromTreeUri(this, parentDirUri);
    if (parentDoc == null || !parentDoc.exists() || !parentDoc.isDirectory()) {
        Toast.makeText(this, "目标目录无效", Toast.LENGTH_SHORT).show();
        return;
    }
    
    // 找到要重命名的文件夹
    DocumentFile targetFolder = parentDoc.findFile(oldFolderName);
    if (targetFolder == null || !targetFolder.exists() || !targetFolder.isDirectory()) {
        Toast.makeText(this, "要重命名的文件夹不存在", Toast.LENGTH_SHORT).show();
        return;
    }
    
    // 执行重命名
    boolean renameSuccess = targetFolder.renameTo(newFolderName);
    if (renameSuccess) {
        Toast.makeText(this, "文件夹重命名成功", Toast.LENGTH_SHORT).show();
    } else {
        Toast.makeText(this, "重命名失败，请检查权限或目录状态", Toast.LENGTH_SHORT).show();
    }
}

关键注意事项 #

• Android 11+权限变化：WRITE_EXTERNAL_STORAGE权限已经被废弃，如果你尝试使用MANAGE_EXTERNAL_STORAGE权限（可以直接访问所有存储），Google Play会对这类APP进行严格审核，除非你的APP是文件管理器类工具，否则不建议使用，SAF是更合规的方案。
• 持久化权限：takePersistableUriPermission方法可以让APP在重启后仍然保留对该目录的访问权限，不需要每次都让用户选择目录。
• 为什么renameTo()不行：物理SD卡的目录属于系统限制的“受保护存储区域”，APP没有直接的文件系统操作权限，只能通过SAF提供的中间层API来完成操作，传统的File类方法无法绕过这个限制。

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