在HBuilderX新建uni-app项目时必须初始化时选定Vue2或Vue3版本，不可后期切换；CLI命令行创建更可靠，需通过package.json和@uni-app版本双重验证实际Vue版本。
在HBuilderX里新建uni-app项目时，必须明确选择Vue2还是Vue3版本，否则后续运行报错、API失效、编译失败几乎不可避免——因为uni-app的Vue版本由项目初始化模板决定，【不可后期通过修改配置文件切换】。
新建项目时如何选Vue2或Vue3
打开HBuilderX → 文件 → 新建 → 项目 → 选择“uni-app”类型 → 点击“下一步” → 在弹出的向导页中，勾选“使用Vue3”复选框即可创建Vue3项目；不勾选则默认创建Vue2项目。
注意：HBuilderX v3.9.12+ 版本默认勾选“使用Vue3”，但旧版（如v3.8.x）仍默认Vue2。若误选，删掉当前项目重来最稳妥，不要试图改manifest.json里的vueVersion字段。
CLI命令行创建Vue3项目（推荐）
方法一：执行标准Vite模板命令
npx degit dcloudio/uni-preset-vue#v3 my-project
方法二：指定TypeScript支持
npx degit dcloudio/uni-preset-vue#vite-ts my-ts-project
这一步操作起来很简单，直接把命令复制粘贴到终端回车就行。生成的项目自带Composition API结构、script setup语法支持和Pinia预配置，无需手动调整入口文件或生命周期钩子。
确认项目实际使用的Vue版本
第一步：打开项目根目录下的package.json
第二步：检查dependencies区块中的vue字段值：
若为"vue": "^2.6.14"或类似2.x版本号 → 是Vue2项目；
若为"vue": "^3.2.0"或更高（如^3.4.21）→ 是Vue3项目。
第三步：同步核对@dcloudio/uni-app版本：
Vue2项目对应@dcloudio/uni-app@2.x；
【Vue3项目必须使用@<dcloudio/uni-app@^3.0.0，否则即使vue装了3.x也会编译失败】。
