Flutter中如何使用file_picker实现Google Drive文件选取

数据老陈

2026-8-26

基于file_picker实现Google Drive文件选取

很多人对file_picker的云存储选取逻辑有误解：它本身不做单独唤起Google Drive、Dropbox这类云盘的逻辑，而是直接调用系统原生的文件选择器，所有已经挂载到系统文件体系的云存储入口，都会自动出现在选择器侧边栏，不需要额外写特殊唤起代码。
具体实现步骤如下：

1. 引入依赖
  在项目pubspec.yaml中添加依赖：

dependencies:
  file_picker: ^6.1.1 # 替换为你项目适配的稳定版本即可

1. 平台权限配置
- 安卓端：Android 13(API 33)及以上版本，在AndroidManifest.xml中添加READ_MEDIA_IMAGES、READ_MEDIA_VIDEO、READ_MEDIA_DOCUMENTS权限；Android 12及以下版本添加READ_EXTERNAL_STORAGE权限即可，不需要额外配置Google Drive相关的密钥或账号参数。
- iOS端：在Info.plist中开启文档拾取权限，同时需要用户提前在系统「文件」app中开启Google Drive的挂载开关（打开文件app→点右上角编辑→打开Google Drive选项），否则选择器中不会出现云盘入口。
1. 核心调用代码
  调用pickFiles方法唤起系统选择器即可，用户可以自行切换到Google Drive目录选择文件，选中的文件会被系统自动缓存到本地临时路径，你直接拿到File对象做展示就行：

/// 拾取Google Drive（及其他本地/云存储）文件
Future<File?> pickDriveFile() async {
  // 唤起系统文件选择器
  FilePickerResult? pickResult = await FilePicker.platform.pickFiles(
    // 要选全类型文件就设为FileType.any，指定类型用FileType.custom
    type: FileType.custom,
    // 自定义允许选择的文件后缀，按业务需求调整
    allowedExtensions: ['pdf', 'doc', 'docx', 'jpg', 'png', 'mp4'],
    // 大文件建议设为false，避免一次性把文件全读进内存导致OOM
    withData: false,
  );

  if (pickResult != null) {
    // 拿到的是系统缓存的本地临时文件，直接读取展示即可
    File selectedFile = File(pickResult.files.single.path!);
    return selectedFile;
  }
  // 用户取消选择的场景返回null
  return null;
}

常见踩坑提醒：

安卓设备必须安装Google Drive app且登录了有效账号，同时设备搭载了可用的Google服务框架，否则系统选择器里不会出现Google Drive入口，国内大部分定制ROM默认砍掉了Google服务，会出现找不到入口的情况。
拿到的临时文件会在应用重启后被系统自动清理，如果需要长期留存文件，要手动把文件复制到应用专属存储目录。
不需要找任何“专门唤起Google Drive”的配置参数，file_picker本身没有这类参数，入口是系统选择器自动提供的。

其他可落地的实现方案

如果file_picker的方案满足不了你的需求（比如需要内嵌云盘文件列表、不依赖系统选择器、要做云盘文件的增删改操作），可以选下面几种方案：

方案1：对接Google Drive官方API
适合需要深度定制云盘交互的场景。流程是先接入谷歌账号登录组件完成用户授权，再通过谷歌官方的Drive接口拉取文件列表、下载文件到本地展示。优点是交互完全可控，不需要跳转系统选择器，还能实现上传、删除、新建文件夹等高级操作；缺点是配置相对繁琐，需要在Google Cloud控制台申请OAuth客户端凭证，还要自己处理授权过期、文件下载断点续传等逻辑。
方案2：通过Schema跳转Google Drive app拾取文件
适合需要强制唤起Google Drive客户端的场景。通过系统路由跳转到Google Drive的文件选择页面，选中文件后通过URL Scheme回传文件数据到你的应用。缺点是适配成本高，不同版本的Google Drive app回传逻辑有差异，安卓和iOS的跳转、回传逻辑不统一，维护成本高，非特殊需求不推荐用。
方案3：接入多网盘聚合插件
适合需要同时接入多个云存储（Google Drive、Dropbox、OneDrive、iCloud等）的项目。这类插件封装好了各个云盘的授权、文件列表拉取、下载逻辑，一次接入就能支持多网盘选文件，缺点是大部分成熟的聚合插件都是付费的，免费版功能限制较多，适合有预算的商用项目使用。

最后补个适配提醒：如果你的应用主要面向国内用户分发，不建议把Google Drive作为核心文件来源，国内绝大多数安卓设备没有完整Google服务，iOS用户挂载Google Drive的比例也极低，一定要做好本地文件选择的兜底逻辑。

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