更新记录

1.0.0（2026-03-15）

• 支持 Android / iOS 系统文件选择
• 支持单选和多选
• 支持后缀过滤
• 支持复制到应用缓存目录
• 返回统一文件信息

平台兼容性

uni-app(4.75)

uni-app x(4.75)

austin-select-files

austin-select-files 是一个 App 全文件选择器 UTS 插件。

点击试用插件

当前目录下的 index.vue 是完整模板页，点击试用后包含：

• 当前平台能力展示
• 可选后缀测试
• 可选数量测试
• 复制到应用缓存目录开关
• 调用 selectFiles
• 最近一次返回结果展示

功能

• 支持 Android / iOS 系统文件选择
• 支持单选和多选
• 支持后缀过滤
• 支持复制到应用缓存目录
• 返回统一文件信息

API

selectFiles(options)

参数：

• count
  • 最多选择数量
  • 不传默认 1
  • Android / iOS 都支持
• extensions
  • 允许选择的后缀数组
  • 例如：['pdf', 'docx', 'xlsx']
  • 不传或传空数组时表示不限制类型
• mimeTypes
  • MIME 类型数组
  • 当前首版更推荐直接传 extensions
• copyToCache
  • 是否复制到应用缓存目录
  • 不传默认 true
  • 开启后返回稳定本地路径，便于后续上传、预览、读取
• success
  • 成功回调
• fail
  • 失败回调
• complete
  • 完成回调

getSelectFilesCapabilities()

返回当前平台能力：

• supported
• platform
• supportsMultiple
• supportsExtensions
• supportsMimeTypes
• supportsCopyToCache
• notes

返回结果

单个文件项包含：

• name
• path
• uri
• size
• ext
• mimeType

完整返回还包含：

• ok
• platform
• count
• copied
• files
• errCode
• errMsg

最小示例

import { selectFiles } from '@/uni_modules/austin-select-files'

selectFiles({
  count: 2,
  extensions: ['pdf', 'docx'],
  copyToCache: true,
  success(res) {
    console.log('select-files-success', res)
  },
  fail(res) {
    console.log('select-files-fail', res)
  },
})

注意

• copyToCache: true 时，返回的是应用自己目录里的稳定路径
• copyToCache: false 时，返回的可能是系统临时路径或原始 uri