Flutter使用file_picker时如何限制用户多选文件的最大数量

原生参数支持说明 #

当前file_picker库并未对外暴露限制最大选择文件数的原生配置参数，无法直接通过传入参数的方式在原生文件选择阶段实现限制。

可选实现方案 #

方案1：选择后校验拦截（推荐） #

这是实现成本最低、兼容性最好的方案，在用户选择文件返回后做长度校验，超过上限直接拦截并给出提示即可，示例代码如下：

// 自定义最大可选择文件数，可根据业务需求调整
const int maxFileCount = 3;
final result = await FilePicker.platform.pickFiles(
  allowMultiple: true,
  type: FileType.custom,
  allowedExtensions: ['jpg','png','mp4'],
);

if (result != null) {
  // 校验选中文件数量
  if (result.files.length > maxFileCount) {
    // 此处替换为你的业务提示逻辑，比如弹出Toast、提示弹窗等
    print("最多只能选择$maxFileCount个文件，请重新选择");
    return;
  }
  // 数量符合要求，继续处理选中文件
  List<PlatformFile> selectedFiles = result.files;
  // 后续业务处理逻辑
}

该方案优势是无需修改依赖源码、兼容全平台，仅几行代码即可实现，适合绝大多数业务场景；劣势是仅在用户选择完成后才做拦截，无法在选择过程中限制用户操作。

方案2：修改原生层源码（体验优化） #

如果需要在文件选择过程中就限制用户选中数量，避免选完再拦截的体验问题，可以自行修改file_picker库的原生层代码：

• Android端：在封装的文件选择Intent中添加对应系统支持的最大数量参数，或者自定义选择逻辑，实时监听用户选中数量，超过上限后禁止继续选中
• iOS端：修改UIDocumentPickerViewController的代理回调方法，用户选中文件时先判断当前已选数量，超过上限直接拦截选中操作
  该方案优势是用户体验更好，选择阶段即可完成限制；劣势是需要手动维护修改后的依赖代码，后续升级file_picker版本时需要同步适配修改内容。

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