Android Studio 将字符串写入本地文件的操作方法

二、文件写入操作

Android 提供了多种 IO 类用于文件写入，常用的有 BufferedWriter 和 FileWriter。两者都支持追加模式。

1. 使用 BufferedWriter 追加内容

BufferedWriter 效率较高，适合大量文本写入。构造参数中的第二个布尔值控制是覆盖还是追加。

public void saveToFile(String content) {
    BufferedWriter out = null;
    try {
        // 获取 SD 卡状态
        String state = Environment.getExternalStorageState();
        // 判断 SD 卡是否就绪
        if (!Environment.MEDIA_MOUNTED.equals(state)) {
            Toast.makeText(this, "请检查 SD 卡", Toast.LENGTH_SHORT).show();
            return;
        }
        
        // 取得 SD 卡根目录
        File file = Environment.getExternalStorageDirectory();
        Log.e(TAG, "======SD 卡根目录：" + file.getCanonicalPath());
        
        // 构建文件路径
        String filePath = file.getCanonicalPath() + "/readMsg.txt";
        
        /*
         * FileOutputStream 构造参数 2: true= 追加内容；false= 覆盖内容
         */
        out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(filePath, true), "UTF-8"));
        out.newLine();
        out.write(content);
        Toast.makeText(this, "保存成功", Toast.LENGTH_SHORT).show();
        
    } catch (IOException e) {
        e.printStackTrace();
        Toast.makeText(this, "保存失败", Toast.LENGTH_SHORT).show();
    } finally {
        if (out != null) {
            try {
                out.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

2. 使用 FileWriter 追加内容

FileWriter 封装了字符编码转换，使用更简便，但性能略低于 BufferedWriter。

/**
 * 使用 FileWriter 进行文本内容的追加
 * @param file 目标文件对象
 * @param content 待写入的内容
 */
private void addTxtToFileWrite(File file, String content) {
    FileWriter writer = null;
    try {
        // FileWriter(file, true), 第二个参数为 true 是追加内容，false 是覆盖
        writer = new FileWriter(file, true);
        writer.write("\r\n"); // 换行符
        writer.write(content);
        writer.flush(); // 确保数据写入磁盘
    } catch (IOException e) {
        e.printStackTrace();
    } finally {
        try {
            if (writer != null) {
                writer.close();
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

最佳实践建议：在现代 Android 开发中，推荐使用 Context.getFilesDir() 或 Context.getExternalFilesDir(null) 来存储应用私有数据。这些目录不需要额外的存储权限，且受系统保护，不会被其他应用随意访问。

三、文件读取操作

读取文件时建议使用字符流（如 BufferedReader），以正确处理中文等 Unicode 字符。

// 从指定路径读取文件
public String readFromFile(String filePath) {
    BufferedReader reader = null;
    StringBuilder sbd = new StringBuilder();
    
    try {
        File file = new File(filePath);
        if (!file.exists()) {
            Toast.makeText(this, "文件不存在", Toast.LENGTH_SHORT).show();
            return "";
        }
        
        FileInputStream fis = new FileInputStream(file);
        // 指定 UTF-8 编码避免乱码
        reader = new BufferedReader(new InputStreamReader(fis, "UTF-8"));
        String row;
        while ((row = reader.readLine()) != null) {
            sbd.append(row).append("\n");
        }
    } catch (FileNotFoundException e) {
        e.printStackTrace();
    } catch (IOException e) {
        e.printStackTrace();
    } finally {
        if (reader != null) {
            try {
                reader.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
    return sbd.toString();
}

四、文件删除操作

删除文件前需先检查文件是否存在，并处理可能的异常。

// 删除 SD 卡文件
public void removeFromFile(String fileName) {
    String state = Environment.getExternalStorageState();
    if (!Environment.MEDIA_MOUNTED.equals(state)) {
        Toast.makeText(this, "SD 卡未就绪", Toast.LENGTH_SHORT).show();
        return;
    }
    
    // 取得 SD 卡根目录
    File root = Environment.getExternalStorageDirectory();
    File myFile = new File(root, fileName);
    
    if (myFile.exists()) {
        boolean deleted = myFile.delete();
        if (deleted) {
            Toast.makeText(this, "文件已删除", Toast.LENGTH_SHORT).show();
        } else {
            Toast.makeText(this, "删除失败", Toast.LENGTH_SHORT).show();
        }
    } else {
        Toast.makeText(this, "文件不存在", Toast.LENGTH_SHORT).show();
    }
}

五、总结与注意事项

本文详细介绍了 Android Studio 中将字符串写入本地文件的基本操作方法，涵盖了权限管理、IO 流的使用以及文件的增删改查。

1. 权限安全：务必处理好 Android 6.0+ 的动态权限申请，否则会导致 SecurityException。
2. 编码格式：读写文件时显式指定 UTF-8 编码，防止中文乱码。
3. 存储路径：随着 Android 版本迭代，外部存储权限逐渐收紧。建议在新项目中优先使用应用私有目录（Internal Storage），仅在必要时才申请外部存储权限。
4. 资源关闭：所有 IO 流操作后必须在 finally 块中关闭流，或使用 try-with-resources 语法，防止内存泄漏。
5. 线程安全：IO 操作属于耗时操作，严禁在主线程（UI 线程）中执行，应放入子线程或使用异步任务处理，以免导致 ANR（Application Not Responding）。

通过上述方法，开发者可以稳健地实现数据的本地持久化存储。