文件存储:内部存储与外部存储

简介: Android文件存储分内部与外部两类:内部存储(`filesDir`)私有安全、无需权限,适合小量敏感数据;外部存储含应用专属目录(`getExternalFilesDir`)和共享媒体(MediaStore),前者同样私有免权限,后者需适配分区存储。合理选用可避免权限错误、数据丢失或泄露。

文件存储:内部存储与外部存储

背景

前面聊过的 SharedPreferences 和 Room 擅长管理键值对与结构化数据。但实际开发中还有一类需求它们搞不定:存储图片、日志文件、下载的文档、缓存的 JSON 数据等——这些场景就需要用到 Android 的文件存储。

Android 文件存储分为两大块:内部存储(Internal Storage)和外部存储(External Storage)。别被名字误导——它们的区别不只是物理位置,权限要求、生命周期、安全隔离才是关键。选错存储位置,轻则功能不生效,重则数据泄露或丢失。

核心概念

内部存储

内部存储是每个应用私有的沙盒目录,位于 /data/data/<包名>/files/。特点:

  • 默认私有:其他应用无法直接访问,用户也看不到。
  • 随应用卸载删除:卸载后数据一并清空。
  • 无需运行时权限:从 API 1 就在用,任何版本都没加过权限限制。
  • 空间有限:和系统分区共享,不适合存大文件。

典型用途:敏感配置、数据库备份、私密密钥等。获取目录的常用 API:

context.filesDir          // /data/data/<包名>/files
context.cacheDir          // /data/data/<包名>/cache(系统可能自动清理)
context.getDir("custom", MODE_PRIVATE)  // /data/data/<包名>/app_custom

外部存储

Android 10(API 29)引入分区存储(Scoped Storage)后,外部存储分两层理解:

  • 应用专属外部目录:getExternalFilesDir() 返回 /sdcard/Android/data/<包名>/files/,同样是私有、无需权限、随卸载删除。
  • 共享存储:通过 MediaStore API 访问公共目录(Pictures、Downloads、Music),需要声明权限。

重点记忆:filesDir(内部)和 getExternalFilesDir()(应用专属外部)都不需要运行时权限,都是应用私有。区别在于后者可能位于可插拔存储设备,空间通常更大。

代码实战(Kotlin)

封装一个文件管理工具类,覆盖写入、读取、删除、缓存清理:

import android.content.Context
import java.io.File

object FileHelper {

    // 写入文本到内部存储
    fun writeToInternal(context: Context, filename: String, content: String) {
        val file = File(context.filesDir, filename)
        file.writeText(content) // Kotlin 扩展,默认 UTF-8
    }

    // 从内部存储读取文本
    fun readFromInternal(context: Context, filename: String): String? {
        val file = File(context.filesDir, filename)
        return if (file.exists()) file.readText() else null
    }

    // 写入到应用专属外部存储
    fun writeToExternalAppDir(context: Context, filename: String, content: String) {
        val dir = context.getExternalFilesDir(null)
        dir?.let {
            if (!it.exists()) it.mkdirs()
            File(it, filename).writeText(content)
        }
    }

    // 按类型获取外部缓存子目录(如图片)
    fun getImageCacheDir(context: Context): File? {
        return context.externalCacheDir?.let {
            val imgDir = File(it, "images")
            if (!imgDir.exists()) imgDir.mkdirs()
            imgDir
        }
    }

    // 删除单个文件
    fun deleteFile(context: Context, filename: String): Boolean {
        return File(context.filesDir, filename).delete()
    }

    // 计算并清理缓存
    fun clearCache(context: Context): Long {
        var totalSize = 0L
        context.cacheDir.walkTopDown().forEach { file ->
            if (file.isFile) {
                totalSize += file.length()
                file.delete()
            }
        }
        return totalSize // 返回清理掉的总字节数
    }
}

Activity 调用示例:

class FileDemoActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_file_demo)

        // 写入配置到内部存储
        FileHelper.writeToInternal(this, "user_config.txt", "darkMode=true")
        // 写入日志到外部专属目录
        FileHelper.writeToExternalAppDir(this, "log.txt",
            "app started at ${System.currentTimeMillis()}")

        // 读取
        val config = FileHelper.readFromInternal(this, "user_config.txt")
        Log.d("FileDemo", "读取配置: $config")

        // 清理缓存
        val freed = FileHelper.clearCache(this)
        Log.d("FileDemo", "清理缓存: $freed bytes")
    }
}

避坑指南

坑一:混淆"外部存储"和"SD 卡"。 getExternalFilesDir() 通常指向机身存储的模拟 SD 卡分区,不一定是物理 SD 卡。不要把路径写死为 /sdcard/。

坑二:直接用文件路径字符串拼接。 永远用 context.filesDir、context.cacheDir、getExternalFilesDir() 等 API 获取路径,兼容不同厂商和 Android 版本。

坑三:不检查外部存储可用性。 外部存储可能被卸载或只读:

val isAvailable = Environment.getExternalStorageState() == Environment.MEDIA_MOUNTED

坑四:大文件放内部存储。 图片、视频、日志等大文件应放到外部存储,内部存储空间有限且会影响系统性能。

坑五:忽略 Android 10+ 分区存储。 targetSdkVersion >= 29 时,访问共享目录必须用 MediaStore 或 SAF(Storage Access Framework),传统文件路径操作会失效。

坑六:忘记清理缓存。 cacheDir 和 externalCacheDir 系统可能自动清理,但不要依赖这一点——在合适时机主动调用 clearCache() 是良好习惯。

总结

Android 文件存储的选择逻辑很简单:私密小文件放内部(filesDir),大文件放应用专属外部目录(getExternalFilesDir),共享媒体用 MediaStore。 内部存储和专属外部目录都无需权限、都是私有;缓存目录(cacheDir / externalCacheDir)适合临时文件,系统可能自动回收。

把文件存储和前面学过的 SharedPreferences、Room 放在一起看,Android 数据持久化体系就完整了:键值对用 SharedPreferences / DataStore,结构化数据用 Room,二进制和大文件用文件存储。 根据数据特征选对存储方式,比炫技代码重要得多。

相关文章
|
5月前
|
SQL 人工智能 关系型数据库
AI Agent 混合检索选型:阿里云 AnalyticDB MySQL 向量+全文一站式方案
阿里云AnalyticDB MySQL版是面向AI Agent/RAG场景的一站式混合检索数据库,原生支持向量检索+全文搜索+结构化查询,单SQL实现三合一。延迟<10ms,成本降60%+,开发提效3倍,显著优于Milvus+Elasticsearch多组件架构。
545 6
|
1月前
|
运维 网络协议 关系型数据库
【新手入门】超全Windows终端CMD常用指令大全(附代码实例+避坑指南)
本文为Windows新手打造了一份超实用的CMD终端指令手册,涵盖文件管理、网络排查、系统运维等高频场景。文章清晰区分CMD与PowerShell的适用场景,提供3种终端打开方式,并分类整理核心指令:①文件操作(dir/cd/copy/del等);②网络命令(ipconfig/ping/tracert);③系统工具(tasklist/shutdown等)。每项指令均附实例和避坑提示,特别强调危险操作如rd/s/q的慎用原则。文末还分享了Tab补全、方向键复用等效率技巧,帮助零基础用户快速掌握
1421 0
|
4月前
|
数据采集 存储 供应链
数据资产到底是什么?一文分清数据资源、数据要素、数字资产和入表!
本文厘清企业数字化中易混淆的七大核心概念:数据资源(可用数据基础)、数据要素(参与价值创造)、数据资产(可控、可计量、能创益)、数字资产(范围更广的数字形态权益)、数据管理(全生命周期执行)、数据治理(权责规则体系)、数字资产入表(需满足会计确认条件)。强调概念递进关系与落地前提,破除“重包装、轻基础”误区。(239字)
|
4月前
|
机器学习/深度学习 编解码 运维
PCB表面缺陷目标检测数据集:6类别、3,500张图像 | 目标检测
本数据集含3500张PCB表面缺陷图像,覆盖漏孔、鼠咬、开路、短路、毛刺、伪铜6类工业缺陷,采用YOLO格式高精度标注,专为小目标检测优化,支持YOLOv8等模型训练与TensorRT部署,助力AOI质检落地。(239字)
412 0
|
4月前
|
运维 Kubernetes 安全
阿里云国际站(云老大):容器安全告警排查教程
容器环境的安全告警正在从偶发事件演变为日常运维的一部分,很多团队在切换到Kubernetes后发现自己被淹没在镜像漏洞和运行时告警中。要真正把排查效率提起来,光看控制台的红字远不够——得先理解告警为什么越来越多、都长什么样。
320 0
|
5月前
|
人工智能 安全 语音技术
阿里云虚拟数字人全栈对接实战:从开通到多端集成与性能优化
本文提供一份完整的阿里云虚拟数字人(DVH)对接实战指南,系统梳理2D/3D数字人、云渲染/端渲染、播报/互动等核心概念与场景选型逻辑。详细拆解服务开通流程、AccessKey与RAM权限配置、控制台数字人项目创建与形象管理、服务端OpenAPI调用(含Java/Python代码示例)、Web端云渲染与端渲染SDK集成(含lm-avatar-chat-sdk完整接入流程)、Android端SDK集成要点、实时对话与离线视频合成实现方案。同时涵盖常见错误排查、安全加固(RAM最小权限、Token鉴权)与成本优化策略(按量付费、包年包月选型、并发路数规划),帮助开发者快速完成从0到1的数字人应用搭
|
11月前
|
人工智能 运维 自然语言处理
阿里云百炼是什么?阿里云百炼登录入口及功能说明
阿里云百炼是什么?阿里云百炼是阿里云推出的一站式大模型开发与应用平台,于 2023 年 10 月发布,后续历经多次升级,成为承载阿里云云 + AI 能力的核心平台,面向企业、开发者及 ISV 技术人员,提供从模型调用到应用构建的全链路服务。 阿里云百炼提供两个核心登录入口,分别对应平台介绍与后台管理功能,开发者可通过对应链接访问相关服务,完成大模型体验与 API 调用操作。
|
9月前
|
前端开发 数据挖掘 应用服务中间件
阿里云服务器2核2G配置可选实例规格,收费标准与活动价格和选购参考
阿里云提供多种2核2G配置的服务器实例规格,包括经济型e、密集计算型ic5、通用算力型u1和u2a等,适用于不同场景,如Web应用、开发测试、轻量级应用及企业级应用,价格因实例规格和付费方式(按量付费或包年包月)而异。2026年,用户可以以38元/年的抢购价购买轻量应用服务器,经济型e实例99元/年且续费同价,通用算力型u2a实例则提供更稳定的企业级性能,用户可根据需求和预算选择合适的实例规格。
|
10月前
|
存储 缓存 固态存储
如何恢复格式化的电脑文件数据
误格式化≠数据消失!快速格式化仅清除索引,文件仍可恢复。关键:立即停止写入、勿装软件、避免覆盖。用专业工具扫描并预览,找回文件后另存他盘。注意SSD的TRIM与文件碎片化影响。冷静+正确操作=高概率拯救数据。备份才是根本!(239字)