Vue CLI 零基础入门:从安装到创建项目,一篇就够

6 阅读3分钟

作为前端小白,刚接触 Vue 时最头疼的就是环境搭建和项目创建,而 Vue CLI 就是帮我们解决这个问题的 “神器”。

它是 Vue 官方提供的脚手架工具,不用手动配置 webpack、不用折腾环境,一行命令就能快速生成一个完整的 Vue 项目,真正做到开箱即用。

今天就用最通俗的语言,带大家从零掌握 Vue CLI,全程实操、无废话!

一、Vue CLI 是什么?

简单理解:Vue CLI = Vue 项目快速生成工具

它的作用:

  • 一键创建 Vue 项目结构
  • 自动配置开发环境
  • 内置热更新(改代码浏览器自动刷新)
  • 帮我们处理打包、编译、语法检查等复杂工作

一句话:有了 Vue CLI,你只需要专注写页面逻辑,其他都不用管。

二、安装 Vue CLI 前置条件

Vue CLI 依赖 Node.js,所以必须先安装 Node.js(LTS 版本即可)。

安装完成后,打开终端(cmd / 终端),检查是否安装成功:

node -v
npm -v

能显示版本号,就说明没问题。

三、安装 Vue CLI

打开管理员终端(Windows 建议管理员运行,避免权限报错),执行安装命令:

npm install -g @vue/cli

-g 表示全局安装,安装一次,电脑所有地方都能用

安装过程可能需要几十秒,耐心等待即可

安装完成后,检查版本:

vue --version

出现版本号,说明 Vue CLI 安装成功!

四、使用 Vue CLI 创建第一个 Vue 项目

1. 进入你想放项目的文件夹

# 示例:创建在桌面
cd Desktop

2. 执行创建命令

vue create vue-demo

vue-demo 是项目名,可以自己改

名称只能小写、不能有空格、不能有中文

3. 选择配置(新手必看)

创建时会让你选择:

Default ([Vue 3] babel, eslint)
Default ([Vue 2] babel, eslint)
Manually select features

小白直接选第一个:Vue 3 默认配置,按回车,等待自动创建。

4. 进入项目

cd vue-demo

5. 启动项目

npm run serve
# 新版也可能是 npm run dev

启动成功后,浏览器访问:

http://localhost:8080

看到 Vue 欢迎页面,项目创建成功!

五、Vue CLI 创建的项目目录结构(小白必懂)

不用死记,知道核心目录就行:

vue-demo/
├── public/        # 静态资源(图片、图标,不参与编译)
├── src/           # 核心代码(99% 开发都在这里)
│   ├── assets/    # 图片、样式
│   ├── components/# 公共组件
│   ├── App.vue    # 根组件
│   └── main.js    # 入口文件
└── package.json   # 项目配置文件

src 是我们以后天天用的文件夹,记住它!

六、Vue CLI 常用命令总结

# 安装 Vue CLI
npm install -g @vue/cli

# 查看版本
vue --version

# 创建项目
vue create 项目名

# 进入项目
cd 项目名

# 启动项目
npm run serve

# 打包项目(上线用)
npm run build

七、小白常见问题(避坑指南)

  • 安装时报权限错误:Windows 用管理员打开终端,Mac 前面加 sudo
  • 命令报错:vue 不是内部命令:重新安装 Node.js,重启电脑
  • 启动项目后浏览器打不开:检查终端是否报错,检查端口是否被占用
  • 修改代码浏览器不刷新:确保项目正在运行(终端不能关)

八、总结

Vue CLI 是 Vue 开发最基础、最必备的工具,它让项目创建变得超级简单:安装 → 创建 → 启动 → 开发,四步搞定。

对于零基础小白来说:不用懂原理,先会用;先能创建项目、能跑起来,再慢慢学习语法。

这篇 Vue CLI 教程就到这里,跟着操作一遍,你绝对能学会!