一、安装 Node.js 和 npm
下载官网 nodejs.org 的 LTS 版本,安装时勾选"Add to PATH"
打开终端输入 node -v 和 npm -v 检查版本,Vue3 推荐 Node.js 18+
二、创建 Vue3 项目
用 npm create vue@latest 或 yarn create vue 命令
选择默认配置 (推荐选"Manually select features"自定义)
注意:选 Vue Router 时要确认是否启用 TypeScript
三、启动开发服务器
进入项目文件夹后执行 npm run dev
默认监听 3000 端口,浏览器打开 http://localhost:3000
踩坑经验 1:npm 安装卡住时删掉 node_modules 再重装,别一直等
四、常见问题排查
报错"Cannot find module 'vue':检查是否安装了 @vue/compat 包
开发服务器无法启动:查端口占用用 lsof -i :3000,杀掉占用进程
样式不生效:确认是否正确导入 CSS 文件,检查浏览器开发者工具
五、开发工具建议
VSCode+Volar 插件组合,支持 Vue3 语法高亮和智能提示
安装 ESLint 规范代码,避免低级语法错误
六、小结
环境搭建是开发基础,遇到问题先查官方文档
实操中注意版本兼容性,避免 npm 缓存污染
养成及时清理 node_modules 的习惯,提升开发效率