uniapp 文件路径
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 }
常见问题解决方案
路径找不到问题 检查路径是否包含非法字符（如中文），建议全部使用英文命名。
跨平台路径兼容 使用条件编译处理不同平台的路径差异，如示例代码所示。
真机调试路径错误
App 平台需注意 iOS 和 Android 的文件系统差异，建议使用 plus.io 接口统一处理。
