当前位置：首页 > uni-app

uniapp 文件路径

2026-02-05 22:39:41uni-app

uniapp 文件路径规范

在 uniapp 中，文件路径的引用需遵循特定的规范，以确保跨平台兼容性。以下是一些关键注意事项：

静态资源路径 静态资源（如图片、字体等）通常放在 static 目录下，引用时无需写 static。例如：

正确写法：/images/logo.png
错误写法：/static/images/logo.png

组件路径 组件路径建议使用相对路径或别名 @。例如：

相对路径：../../components/myComponent.vue
别名路径：@/components/myComponent.vue

API 文件路径 在 uni. 系列 API 中（如 uni.uploadFile），文件路径需使用平台绝对路径。可通过 plus.io.convertLocalFileSystemURL 或 wx.getFileSystemManager 转换。

动态路径处理

动态生成路径时需注意平台差异：

H5 平台直接使用 / 开头的路径。
小程序平台需调用 wx.env.USER_DATA_PATH 获取用户目录。
App 平台使用 plus.io 转换路径。

代码示例：

// 获取临时文件路径
uni.chooseImage({
  success: (res) => {
    const tempFilePaths = res.tempFilePaths
    // 处理不同平台路径
    #ifdef H5
    const path = tempFilePaths[0]
    #endif
    #ifdef MP-WEIXIN
    const path = wx.env.USER_DATA_PATH + '/temp.jpg'
    #endif
    #ifdef APP-PLUS
    const path = plus.io.convertLocalFileSystemURL(tempFilePaths[0])
    #endif
  }
})

路径转换工具

推荐使用以下方法处理跨平台路径问题：

uni.getFileSystemManager()（小程序）
plus.io.resolveLocalFileSystemURL()（App）

自定义路径转换函数：

function getPlatformPath(path) {
#ifdef H5
return path
#endif
#ifdef MP-WEIXIN
return `${wx.env.USER_DATA_PATH}/${path}`
#endif
#ifdef APP-PLUS
return plus.io.convertLocalFileSystemURL(path)
#endif
}