更新记录

1.0.1（2026-03-18）

修复安卓extensions无效，导致显示了所有文件格式

1.0.0（2026-03-18）

• 初始版本
• 支持Android/iOS/HarmonyOS文件选择
• 支持文件类型过滤：all / audio / video / image / document
• 支持后缀过滤
• 支持多选（count 参数）
• 返回文件本地路径（file://）、文件名、大小、MIME 类型、扩展名

平台兼容性

uni-app(4.0)

uni-app x(5.0)

其他

dh-choose-file

Android / iOS / HarmonyOS 原生文件选择插件，支持按类型过滤音频、视频、图片、文档等文件，也支持按扩展名精确过滤。

平台支持

安装

将 dh-choose-file 目录放入项目的 src/uni_modules/ 下即可。

使用

import { chooseFile } from '@/uni_modules/dh-choose-file'

// 按文件类型过滤
chooseFile({
  fileTypes: ['audio'],
  success: (res) => {
    const file = res.files[0]
    console.log('文件路径:', file.path)
    console.log('文件名:', file.name)
    console.log('文件大小:', file.size, 'bytes')
    console.log('MIME 类型:', file.mimeType)
    console.log('扩展名:', file.extension)
  },
  fail: (err) => {
    if (err.errCode === 8020001) {
      console.log('用户取消选择')
    } else {
      console.error('选择失败:', err.errMsg)
    }
  },
})

// 多选（最多 3 个），同时支持音频和视频
chooseFile({
  count: 3,
  fileTypes: ['audio', 'video'],
  success: (res) => {
    for (const file of res.files) {
      console.log(file.name, file.path)
    }
  },
})

// 按扩展名精确过滤（优先级高于 fileTypes）
chooseFile({
  extensions: ['mp3', 'wav', 'flac'],
  success: (res) => { ... },
})

// 选择所有类型文件
chooseFile({
  fileTypes: ['all'],
  success: (res) => { ... },
})

参数说明

ChooseFileOptions

fileTypes 支持的值

可传多个值，如 ['audio', 'video'] 表示同时显示音频和视频文件。

extensions 优先级高于 fileTypes：若同时传入 extensions，fileTypes 不生效。

ChooseFileItem（文件信息）

错误码

权限配置

三个平台均无需声明任何权限。

注意事项

• 返回的 path 是应用缓存目录中的文件副本（Android 复制自 content URI，iOS asCopy=true），应用退出后可能被系统清理
• 如需持久化存储，请将文件从 path 复制到应用 Documents 目录
• Android 的文件复制在 UI 线程执行，选择大文件时建议配合 loading 提示
• iOS 最低版本要求 14+（UIDocumentPickerViewController(forOpeningContentTypes:asCopy:) 在 iOS 14 引入）