uni-app 项目支持 vue 3.0 详解及版本升级方案？

uni-app 支持 Vue 3.0 详解及升级方案

一、uni-app 对 Vue 3.0 的支持现状

uni-app 从 3.0 版本 开始支持 Vue 3.0，主要变化包括：

1. 核心框架升级：

   • 基于 Vue 3.0 的 Composition API 和 Options API 双模式支持
   • 提供 @vueuse/core 等组合式 API 工具集
   • 支持 <script setup> 语法糖

2. 性能优化：

   • 虚拟 DOM 性能提升
   • 响应式系统重构，减少内存占用
   • 编译时优化，生成更高效的渲染函数

3. 兼容性：

   • 完全兼容 Vue 2.x 语法
   • 大部分 Vue 2.x 插件可通过适配继续使用
   • 跨端能力保持不变（H5、小程序、App）

二、创建 Vue 3.0 项目

创建新的 uni-app 项目时，可通过以下方式选择 Vue 3.0：

1. 使用 HBuilderX 创建：

   • 新建项目 → 选择 "uni-app"
   • 在模板选项中选择 "Vue 3.0" 模板

2. 使用 CLI 创建：

# 安装最新版 HBuilderX CLI
npm install -g @dcloudio/uni-cli-i18n

# 创建 Vue 3.0 项目
uni create -t vue3 my-vue3-project

三、现有项目升级到 Vue 3.0

重要提示：升级前务必备份项目！

1. 升级 uni-app 到最新版本

# 更新 HBuilderX 到最新版
# 或使用 CLI 更新
npm update @dcloudio/uni-app-plus

2. 修改项目配置

在 package.json 中修改 uni-app 相关依赖：

{
  "dependencies": {
    "vue": "^3.2.47",
    "uni-app-plus": "^3.5.0",
    "@dcloudio/uni-ui": "^1.6.0"
  }
}

3. 迁移代码

Vue 3.0 与 Vue 2.x 语法兼容，但部分 API 需要调整：

1. 全局 API 变化：

   // Vue 2.x
   import Vue from 'vue';
   Vue.prototype.$myMethod = () => {};
   
   // Vue 3.0
   import { getCurrentInstance } from 'vue';
   const { proxy } = getCurrentInstance();
   proxy.$myMethod = () => {};

2. 组合式 API 转换：

   // Vue 2.x Options API
   export default {
     data() {
       return { count: 0 };
     },
     methods: {
       increment() { this.count++; }
     }
   }
   
   // Vue 3.0 Composition API
   import { ref } from 'vue';
   export default {
     setup() {
       const count = ref(0);
       const increment = () => count.value++;
       return { count, increment };
     }
   }

3. 生命周期钩子变化：

   // Vue 2.x
   export default {
     created() {},
     mounted() {},
     beforeDestroy() {}
   }
   
   // Vue 3.0
   import { onMounted, onUnmounted } from 'vue';
   export default {
     setup() {
       onMounted(() => {});
       onUnmounted(() => {});
     }
   }

四、Vue 3.0 新特性在 uni-app 中的应用

1. <script setup> 语法糖

<template>
  <view>
    <text>{{ count }}</text>
    <button @click="increment">+1</button>
  </view>
</template>

<script setup>
import { ref } from 'vue';

// 响应式数据
const count = ref(0);

// 方法
const increment = () => {
  count.value++;
};
</script>

2. Composition API

// 封装可复用的逻辑
import { ref, onMounted, onUnmounted } from 'vue';

export function useMousePosition() {
  const x = ref(0);
  const y = ref(0);

  const updatePosition = (e) => {
    x.value = e.pageX;
    y.value = e.pageY;
  };

  onMounted(() => {
    window.addEventListener('mousemove', updatePosition);
  });

  onUnmounted(() => {
    window.removeEventListener('mousemove', updatePosition);
  });

  return { x, y };
}

3. 响应式系统增强

import { reactive, computed } from 'vue';

const state = reactive({
  name: 'John',
  age: 30
});

const doubleAge = computed(() => state.age * 2);

五、注意事项与常见问题

1. 插件兼容性：

   • 部分 Vue 2.x 插件需要升级到 Vue 3.0 版本
   • 如使用 Vuex，需升级到 @vueuse/core 或 pinia

2. 性能优化：

   • 使用 v-memo 和 v-once 减少不必要的渲染
   • 避免频繁创建响应式对象

3. 调试工具：

   • 使用 Vue DevTools 6.0+ 版本调试 Vue 3.0 应用

4. HBuilderX 版本：

   • 确保使用 HBuilderX 3.2.0+ 版本
   • 部分新特性需要最新版 HBuilderX 支持

六、推荐升级方案

1. 新项目优先使用 Vue 3.0：

   • 利用 Composition API 提高代码可维护性
   • 享受 Vue 3.0 的性能优势

2. 现有项目渐进式升级：

   • 先升级 uni-app 框架
   • 逐步将组件迁移到 Composition API
   • 遇到兼容性问题时，保持原有 Vue 2.x 语法

3. 第三方库适配：

   • 检查并更新项目依赖的第三方库
   • 对不兼容的库，考虑替换或自行封装适配器

总结

uni-app 3.0 对 Vue 3.0 的支持已经相当成熟，升级后可以获得更好的性能和开发体验。对于新项目，强烈推荐使用 Vue 3.0；对于现有项目，可以根据实际情况选择渐进式升级或保持现状。升级过程中需要注意插件兼容性和 API 变化，建议在测试环境充分验证后再部署到生产环境。