如何让MediaStore写入文件时覆盖已有同名文件而非创建新文件？

你的问题很典型——默认用insert()方法时，MediaStore会自动重命名同名文件来避免冲突，所以想要覆盖的话，得先检查目标文件是否存在，存在就直接更新，不存在再创建新文件。

下面是修改后的完整代码，我会逐段解释逻辑：

fun exportToFile(fileName: String, content: String) {
    val context = // 确保这里有可用的Context实例
    val extVolumeUri: Uri = MediaStore.Files.getContentUri("external")
    
    // 第一步：查询Downloads目录下是否已存在同名文件
    val projection = arrayOf(MediaStore.MediaColumns._ID)
    val selection = "${MediaStore.MediaColumns.DISPLAY_NAME} = ? AND ${MediaStore.MediaColumns.RELATIVE_PATH} = ?"
    val selectionArgs = arrayOf(fileName, "${Environment.DIRECTORY_DOWNLOADS}/")
    
    context.contentResolver.query(
        extVolumeUri,
        projection,
        selection,
        selectionArgs,
        null
    )?.use { cursor ->
        if (cursor.moveToFirst()) {
            // 找到已有文件，获取它的Uri
            val id = cursor.getLong(cursor.getColumnIndexOrThrow(MediaStore.MediaColumns._ID))
            val existingFileUri = ContentUris.withAppendedId(extVolumeUri, id)
            
            // 打开输出流并覆盖写入（"wt"模式会清空原有内容）
            context.contentResolver.openOutputStream(existingFileUri, "wt")?.use { os ->
                os.write(content.toByteArray())
            }
            return // 处理完已有文件，直接返回
        }
    }
    
    // 第二步：如果文件不存在，创建新文件（保留你原来的逻辑）
    val contentValues = ContentValues().apply {
        put(MediaStore.MediaColumns.DISPLAY_NAME, fileName)
        put(MediaStore.MediaColumns.MIME_TYPE, "text/plain")
        put(MediaStore.MediaColumns.RELATIVE_PATH, Environment.DIRECTORY_DOWNLOADS)
    }
    
    val fileUri = context.contentResolver.insert(extVolumeUri, contentValues)
    fileUri?.let { uri ->
        context.contentResolver.openOutputStream(uri, "wt")?.use { os ->
            os.write(content.toByteArray())
        }
    }
}

关键逻辑说明： #

• 查询已有文件：通过query()方法筛选Downloads目录下DISPLAY_NAME匹配的文件，这里注意RELATIVE_PATH要加上末尾的斜杠（比如Downloads/），避免匹配到子目录里的同名文件。
• 覆盖写入：找到已有文件的Uri后，用openOutputStream(uri, "wt")打开流，"wt"模式表示写入文本并截断原有内容，刚好满足覆盖需求。
• 资源自动关闭：用use函数包裹Cursor和OutputStream，能自动处理资源关闭，避免内存泄漏。

额外注意事项： #

• 对于Android 10（API 29）及以上，写入Downloads目录不需要WRITE_EXTERNAL_STORAGE权限，但如果是Android 9及以下，你需要在Manifest中声明该权限并请求运行时权限。
• 如果你的文件名包含特殊字符，查询时可能需要调整筛选逻辑，但一般情况下上述代码可以覆盖大部分场景。

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