1. Vue CLI 项目常用指令
创建项目
npm install -g @vue/cli # 全局安装 Vue CLI
vue create my-project # 创建新项目
开发运行
npm run serve # 启动开发服务器
# 或
yarn serve
构建生产版本
npm run build # 构建生产版本
# 或
yarn build
其他常用指令
npm run lint # 运行 ESLint 检查
npm run test # 运行测试
2. Vite 项目常用指令
创建项目
npm create vite@latest my-vue-app --template vue
# 或
yarn create vite my-vue-app --template vue
开发运行
npm run dev # 启动开发服务器
# 或
yarn dev
构建生产版本
npm run build # 构建生产版本
# 或
yarn build
预览生产构建
npm run preview # 本地预览生产构建
# 或
yarn preview
3. VSCode 中运行 Vue 项目的实用技巧
调试配置
在 .vscode/launch.json 中添加 Vue 调试配置:
{
"version": "0.2.0",
"configurations": [
{
"type": "chrome",
"request": "launch",
"name": "vuejs: chrome",
"url": "http://localhost:8080",
"webRoot": "${workspaceFolder}/src",
"breakOnLoad": true,
"sourceMapPathOverrides": {
"webpack:///src/*": "${webRoot}/*"
}
}
]}
常用扩展命令
- 在 VSCode 终端中运行上述 npm/yarn 命令
- 使用 Volar 扩展提供的 Vue 语言功能
- 使用 ESLint 扩展实时检查代码
- 使用 Prettier 扩展格式化代码 (Shift+Alt+F)
代码片段
在 Vue 文件中,可以使用以下 Emmet 缩写:
- vbase → 生成 Vue 单文件组件基础模板
- vfor → 生成 v-for 指令
- vmodel → 生成 v-model 指令
4. 常见问题解决
端口占用
# 查看占用端口的进程
netstat -ano | findstr :8080
# 然后终止进程
taskkill /PID <PID> /F
依赖问题
# 清除缓存并重新安装
npm cache clean --force
rm -rf node_modules
npm install #下载依赖
ESLint 错误
# 自动修复可修复的错误
npm run lint -- --fix
5. 项目结构说明
典型 Vue 项目结构:
my-project/
├── node_modules/ # 依赖包
├── public/ # 静态资源
├── src/ # 源代码
│ ├── assets/ # 静态资源
│ ├── components/ # 组件
│ ├── router/ # 路由
│ ├── store/ # Vuex/Pinia 状态管理
│ ├── views/ # 页面级组件
│ ├── App.vue # 根组件
│ └── main.js # 入口文件
├── .eslintrc.js # ESLint 配置
├── package.json # 项目配置
└── vite.config.js # Vite 配置 (或 vue.config.js)