如何在Jetpack Compose中显示文本文件(.txt)

下面分两种常见场景给出实现方案：

1. 读取Assets目录下的文本文件 #

首先实现读取Assets文件的工具方法：

fun readTxtFromAssets(context: Context, fileName: String): String {
    return try {
        context.assets.open(fileName).use { inputStream ->
            val buffer = ByteArray(inputStream.available())
            inputStream.read(buffer)
            String(buffer)
        }
    } catch (e: IOException) {
        e.printStackTrace()
        "读取失败: ${e.message}"
    }
}

然后在Compose界面中加载并展示内容：

@Composable
fun AssetsTxtViewer(context: Context) {
    val txtContent = remember { mutableStateOf("") }

    // 启动时读取文件
    LaunchedEffect(Unit) {
        txtContent.value = readTxtFromAssets(context, "sample.txt")
    }

    // 用滚动容器包裹文本，适配长内容
    SingleChildScrollView(
        modifier = Modifier.fillMaxSize().padding(horizontal = 16.dp, vertical = 12.dp)
    ) {
        Text(
            text = txtContent.value,
            fontSize = 14.sp,
            lineHeight = 20.sp,
            color = Color.Black
        )
    }
}

2. 读取外部存储的文本文件 #

权限配置 #

在AndroidManifest.xml中添加对应权限：

<!-- Android 13及以下读取外部存储 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32"/>
<!-- Android 10+推荐用SAF，避免申请全存储权限 -->

读取文件方法（通过Uri） #

fun readTxtFromUri(context: Context, uri: Uri): String {
    return try {
        context.contentResolver.openInputStream(uri)?.use { inputStream ->
            BufferedReader(InputStreamReader(inputStream)).useLines { lines ->
                lines.joinToString("\n")
            }
        } ?: "无法获取文件流"
    } catch (e: IOException) {
        e.printStackTrace()
        "读取失败: ${e.message}"
    }
}

Compose界面实现（包含文件选择） #

@Composable
fun ExternalTxtViewer(context: Context) {
    val txtContent = remember { mutableStateOf("") }
    // 注册文件选择器
    val filePickerLauncher = rememberLauncherForActivityResult(
        contract = ActivityResultContracts.GetContent(),
        onResult = { uri ->
            uri?.let {
                txtContent.value = readTxtFromUri(context, it)
            }
        }
    )

    Column(
        modifier = Modifier.fillMaxSize().padding(16.dp),
        verticalArrangement = Arrangement.Top
    ) {
        // 文件选择按钮
        Button(onClick = { filePickerLauncher.launch("text/plain") }) {
            Text("选择本地文本文件")
        }

        Spacer(modifier = Modifier.height(16.dp))

        // 展示文本内容
        SingleChildScrollView(
            modifier = Modifier.weight(1f)
        ) {
            Text(
                text = txtContent.value,
                fontSize = 14.sp,
                lineHeight = 20.sp
            )
        }
    }
}

注意事项 #

• 处理大文件时，避免一次性读取全部内容，可考虑分段加载或使用流式展示，防止OOM
• Android 10+建议使用Storage Access Framework（SAF）访问外部文件，减少权限申请
• 所有文件操作都要捕获IO异常，避免崩溃

内容的提问来源于stack exchange，提问作者Tippu Fisal Sheriff