新手友好！使用Vue Cli快速构建项目全指南

Vue Cli 是 Vue 官方提供的脚手架工具，能帮我们快速搭建标准化的 Vue 项目结构，自动配置 webpack、ESLint 等复杂依赖，让我们无需关注底层配置，专注于业务开发。本文将从环境准备到项目运行，一步步带大家完成 Vue 项目的快速构建，新手也能轻松跟上！

一、前置环境准备

Vue Cli 依赖 Node.js 环境，所以在安装Vue Cli之前，需要先确保本地已安装 Node.js 和 npm（npm 是 Node.js 自带的包管理工具）。

1. 检查是否已安装Node.js

打开终端（Windows：cmd或PowerShell；Mac/Linux：Terminal），输入以下命令：

bash
node -v
npm -v

如果输出类似v16.18.0（Node.js 版本）和8.19.2（npm 版本）的信息，说明已安装；如果提示“不是内部或外部命令”，则需要先安装 Node.js。

2. 安装Node.js

前往 Node.js 官网（https://nodejs.org/），下载对应系统的稳定版（LTS版本，推荐新手使用），双击安装包后按默认步骤完成安装即可。

安装完成后，重新打开终端，再次执行node -v和npm -v，确认安装成功。

二、安装Vue Cli

Node.js 安装完成后，通过 npm 全局安装 Vue Cli。在终端中输入以下命令：

bash
npm install -g @vue/cli

说明：

-g表示全局安装，这样在任何目录下都能使用vue命令；

如果安装过程中出现权限错误（如 Mac/Linux 下的EACCES错误），可以在命令前加上sudo（即sudo npm install -g @vue/cli），然后输入系统密码即可；

Windows 用户如果出现权限问题，可以右键终端选择“以管理员身份运行”后再执行命令。

安装完成后，验证是否安装成功：

bash
vue --version

如果输出类似@vue/cli 5.0.8的版本信息，说明 Vue Cli 安装成功！

三、使用Vue Cli创建项目

Vue Cli 提供了可视化界面（GUI）和命令行（CLI）两种创建方式，下面分别介绍，大家可以根据习惯选择。

方式一：命令行创建（推荐新手熟悉流程）

进入项目存放目录：在终端中通过cd命令进入你想存放项目的文件夹，例如：# Windows示例：进入D盘的projects文件夹
cd D:\projects

# Mac/Linux示例：进入用户目录的projects文件夹
cd ~/projects

创建项目：输入以下命令，其中my-vue-project是项目名称（可以自定义，建议使用小写字母+连字符的格式，如vue-demo-app）：vue create my-vue-project

选择项目模板：执行命令后，终端会出现模板选择界面，包含三种选项：Default ([Vue 3] babel, eslint)：默认模板，适用于 Vue 3 项目，包含 babel（ES6 转 ES5）和 eslint（代码规范检查）；

Default ([Vue 2] babel, eslint)：默认模板，适用于 Vue 2 项目；

Manually select features：手动选择功能，适合需要自定义配置（如路由、Vuex、CSS 预处理器等）的场景。

等待项目创建：选择模板后，Vue Cli 会自动下载项目依赖包，耐心等待即可（速度取决于网络，若速度较慢，可以考虑配置 npm 镜像，下文有说明）。

项目创建成功：终端出现Successfully created project my-vue-project提示时，说明项目创建完成。

方式二：可视化界面创建（操作更直观）

如果觉得命令行不直观，可以使用Vue Cli的可视化界面创建项目：

在终端中输入以下命令，启动可视化界面：vue ui

命令执行后，会自动打开浏览器，进入 Vue 项目管理器界面（默认地址：http://localhost:8000）。

点击界面中的“创建”按钮，选择项目存放目录，输入项目名称，点击“下一步”。

选择项目模板（和命令行一致，默认或手动选择），点击“创建项目”，等待依赖下载完成即可。

四、运行Vue项目

项目创建完成后，进入项目目录并启动开发服务器：

进入项目目录：cd my-vue-project

启动开发服务器：npm run serve

启动成功后，终端会输出项目访问地址，通常是http://localhost:8080/（如果 8080 端口被占用，会自动使用其他端口，如 8081）。

打开浏览器，输入该地址，就能看到Vue的默认欢迎页面，说明项目运行成功！

五、项目目录结构说明（新手必看）

创建完成的Vue项目目录结构如下（以Vue 3默认模板为例）：

plaintext
my-vue-project/
├── node_modules/ # 项目依赖包（npm install下载的文件）
├── public/ # 静态资源目录（不会被webpack处理）
│ ├── favicon.ico # 网站图标
│ └── index.html # 入口HTML文件
├── src/ # 核心代码目录（开发主要关注这里）
│ ├── assets/ # 静态资源（会被webpack处理，如图片、样式）
│ ├── components/ # 公共组件目录
│ ├── App.vue # 根组件（项目入口组件）
│ └── main.js # 入口JS文件（初始化Vue实例）
├── .gitignore # git忽略文件（指定不提交到git的文件）
├── babel.config.js # babel配置文件（ES6转ES5）
├── package.json # 项目配置文件（依赖、脚本命令等）
└── README.md # 项目说明文档

核心目录说明：

src：开发的核心目录，几乎所有业务代码都写在这里；

src/App.vue：根组件，所有页面都是在这个组件基础上组合而成；

src/main.js：入口文件，负责创建 Vue 实例并挂载到 HTML 页面的 DOM 元素上；

public/index.html：唯一的 HTML 文件，Vue 是单页应用（SPA），所有页面内容都通过 JS 动态插入到这个文件中。

六、常见问题解决

1. npm安装依赖速度慢/失败

原因：npm默认使用国外镜像，国内网络访问较慢。解决方案：配置npm淘宝镜像：

bash
npm config set registry https://registry.npm.taobao.org

配置完成后，重新执行安装命令即可。

2. 启动项目时端口被占用

解决方案1：关闭占用端口的程序（可通过任务管理器查找对应端口的进程）；

解决方案2：修改项目启动端口，在package.json中修改scripts里的serve命令：

json
"scripts": {
"serve": "vue-cli-service serve --port 8081", // 改为8081或其他未被占用的端口
"build": "vue-cli-service build"
}

修改后重新执行npm run serve即可。

3. 执行vue命令提示“不是内部或外部命令”

原因：Vue Cli未全局安装成功，或Node.js的环境变量未配置。解决方案：

重新执行npm install -g @vue/cli安装；

检查 Node.js 的环境变量（Windows：右键“此电脑”→属性→高级系统设置→环境变量→Path 中添加 Node.js 的安装路径；Mac/Linux 无需手动配置）。

七、后续开发建议

如果需要路由（页面跳转）、状态管理（Vuex/Pinia）等功能，可以在创建项目时选择“Manually select features”手动添加，或后续通过npm install vue-router pinia手动安装；

开发完成后，执行npm run build命令，会生成dist目录，里面是打包后的静态文件，可直接部署到服务器；

如果需要修改 webpack 配置，可以在项目根目录创建vue.config.js文件进行自定义配置（参考 Vue Cli 官方文档）。

总结

使用 Vue Cli 构建项目的核心流程就是：准备 Node.js 环境 → 安装 Vue Cli → 创建项目 → 运行项目，整个过程无需关注复杂的底层配置，新手也能快速上手。如果在操作过程中有任何问题，可以查看 Vue Cli 官方文档（https://cli.vuejs.org/）或留言讨论。祝大家开发顺利！

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/1120712.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！