Android - 文件存储

原创 2025-11-26 23:34:13 10w+ 阅读 AI写同款

收录于

Android

Jomurphys

码龄9年墨衍会员 · AI 创作全网分发

1768粉丝261篇原创

关注

Android 11 存取文件或保存取出图片到目录前言今天遇到个问题，在安卓10以下保存图片到目录有效，在安卓11上就不行。有问题的代码是这样的 String path = Environment.getExternalStorageDirectory()+"/DirName/"+"123.jpg"; 上面这句代码获取的是文件的根目录。最终的解决办法是，把上述代码换成下面这个代码： //下面这段代码获取的目录是//storage/emulated/0/Android/data/com.microhabit/files/DirName/ 阅读详情

AI摘要

本文介绍Android中内置存储与外部存储的区别及使用方式，涵盖私有目录、公有目录的访问机制，并重点说明Android 10及以上版本通过MediaStore和Storage Access Framework实现的分区存储规范，帮助开发者合理管理应用文件。

官方页面

一、概念

机身存储在概念上被分为了内置存储和外置存储，插存储卡或外接U盘硬盘都属于外置存储（这年头几乎都不支持插卡，就算外接这种场景属于用户主动转移文件，而不是APP要考虑往那里存）。
含有包名的路径都可以使用Context中的方法，不含有包名的路径和APP无关可以通过Environment中的方法来访问。

	路径	谁还可以访问	APP卸载后存储的数据文件	权限申请
内置存储	私有目录 data/data/包名/	只有自己，除非root。	一起删除（存储的文件会算入到该APP的存储占用中）	不需要
外部存储	专有目录 storage/sdcard/Android/data/包名/	对于小米，HyperOS 系统自带文件管理器可以直接访问，MIUI 自带文件管理器会跳转到原生File软件访问。第三方APP无法访问。	一起删除（存储的文件会算入到该APP的存储占用中）	Android 4.4 以后不需要
	公有目录 storage/sdcard0/名称/	第三方APP，适合存放共享的文件。	不会删除（存储的文件不会算入该APP的存储占用中）	需要
	自定义目录 storage/sdcard0/	Android 9及以前的第三方APP	不会删除（存储的文件不会算入该APP的存储占用中）	需要

二、内置存储 Internal Storage

路径：data/data/包名/

存储的数据不会被其它APP访问到（除非Root），APP卸载会一并删除，空间有限适合存储小数据。files目录存放持久化数据、cahce存放缓存数据（空间不足会被系统清理）、shared_prefs存放SharedPreference键值对文件，databases存放SQlite数据库文件。

getDataDir( )	根目录：/data/user/0/包名
getFilesDir( )	文件目录：data/data/包名/files
getCacheDir( )	缓存目录：data/data/包名/ceche
openFileOutput(String name,int mode)	写入文件到内部存储files目录，模式有MODE_PRIVATE私有、MODE_APPEND追加(重复调用不覆盖而是接着已存在的文件后面写)。
openFileInput(String name)	从内部存储读取文件

FileOutputStream fos = openFileOutput("文件.txt", MODE_PRIVATE);
String s = "今天天气不错";
fos.write(s.getBytes());
fos.close();
//写入
try {
    val output = openFileOutput("data", MODE_PRIVATE)
    val writer = BufferedWriter(OutputStreamWriter(output))
    //use会自动关闭流，不用手写finally去close。
    writer.use { it.write(inputText) }
} catch (e: IOException) { e.printStackTrace() }
//读取
try {
    val input = openFileInput("data")
    val reader = BufferedReader(InputStreamReader(input))
    //forEachLine会将读到的每行内容都回调到Lambda表达式中
    reader.use { reader.forEachLine { content.append(it) } }
} catch (e: IOException) { e.printStackTrace() }

三、外部存储 External Storage

存储的数据可以被其它APP访问到。

3.1 私有目录

路径：storage/emulated/Android/data/包名/

私有目录就是Android这个文件夹，这个文件夹打开之后里边有一个data文件夹，打开这个data文件夹，里边有许多包名组成的文件夹。这个目录中的文件会被计入到应用程序的占用空间当中，同时也会随着应用程序的卸载而被删除（这样有利于系统维护也避免用户的反感）。

getExternalFilesDir(String type)

填入 null 返回根目录：storage/emulated/0/Android/data/包名/files，或以下子目录：

Environment. DIRECTORY_MUSIC //音乐（根目录拼接/Music）

Environment. DIRECTORY_PODCASTS //播客

Environment. DIRECTORY_RINGTONES //铃声

Environment. DIRECTORY_ALARMS //闹钟

Environment. DIRECTORY_NOTIFICATIONS //通知

Environment. DIRECTORY_PICTURES //图片

Environment. DIRECTORY_MOVIES //视频

Environment. DIRECTORY_DICM //手机拍摄的照片或视频

Environment. DIRECTORY_DOCUMENTS //文档

Environment. DIRECTORY_DOWNLOADS //下载

Environment. DIRECTORY_SCREENSHOTS //截屏

Environment. DIRECTORY_RECORDINGS //录像

getExternalCacheDir( )

缓存目录：storage/emulated/0/Android/data/包名/cache

~~getExternalMediaDir~~

~~已废弃：storage/emulated/0/Android/media~~

3.2 公有目录

路径：storage/emulated/0/

由系统创建的公有目录有九大类：DCIM相机、Screenshots截图、Download下载、Pictures图片、Movies电影、Documents文档、Music音乐、Ringtones铃声、Alarms闹铃、Notifications通知音。存储的文件不会计入到应用程序的占用空间当中，APP删除后不会删除存储在这里的数据。

Android9(api28)及以前：对任何文件读写均可读写。需要权限 READ_EXTERNAL_STORAGE 或 WRITE_EXTERNAL_STORAGE。
Android10(api29)或更高：自己APP贡献的文件可自由读写，默认对别人APP贡献的文件只能读，实在要修改需要跳转页面让用户手动授权。

3.2.1 通过 Environment 访问（Android 9及以前）

Environment.getExternalStorageDirectory()

根目录：storage/emulated/0

Environment.getExternalStoragePublicDirectory(DIRECTORY_DCIM)

Environment.getExternalStoragePublicDirectory(DIRECTORY_ALARMS)

相机目录：storage/sdcard0/DCIM

闹铃目录：storage/sdcard0/Alarms

if(Environment.getExternalStorageState.equals(Environment.MEDIA_MOUNTED)){	
    //判断SD卡是否存在
    File dir = Environment.getExternalStorageDirectory();	//获取SD卡目录
    long totalSpace = dir.getTotalSpace();		//获取SD卡总大小
    long usableSpace = dir.getUsableSpace();		//获取SD卡可用空间
    String totalSize = Formatter.formatFileSize(this,totalSpace);	//格式化可用大小，自动换算成合适的单位
    String usableSize = Formatter.formatFileSize(this,usableSpace);	//格式化可用大小，自动换算成合适的单位
}

3.2.2 通过 MediaStore 访问（Android 10 及以后）

详见：分区存储（MediaStore、SAF）

分区存储（Scoped Storage）的推出是针对 APP 访问外部存储的行为（乱建乱获取文件和文件夹）进行规范和限制，以减少混乱使得用户能更好的控制自己的文件。公有目录被分为两大类：媒体文件（图片、音频、视频）的访问使用 MediaStore，其它文件通过系统的文件选择器访问 Storage Access Framework（简称SAF）。

3.3 自定义目录

路径：storage/sdcard0/

通过 File 手动在外置存储的根目录下创建自定义文件夹，APP删除后不会删除存储在这里的数据。为了让用户更好地管理自己的文件并减少混乱，Android10 及以后不支持自建目录。

类名	API	说明
File	createNewFile()	创建文件
	mkdir()	创建单级文件目录
	mkdirs()	创建多级文件目录
	delete()	删除文件或目录
FileInputStream	FileInputStream(File)	创建文件输入流（File对象）
	FileInput(fileName)	创建文件输入流（文件名）
	read()	从创建文件输入流中读取指定字节内容
FileOutputStream	FileOutputStream(File)	创建文件输出流（File对象）
	FileOutputStream(fileName)	创建文件输出流（文件名）
	write()	将指定内容写入创建文件输出流