【愚公系列】《循序渐进Vue.js 3.x前端开发实践》043-VUE CLI工具入门

举报
愚公搬代码 发表于 2025/02/28 23:31:59 2025/02/28
【摘要】 标题详情作者简介愚公搬代码头衔华为云特约编辑,华为云云享专家,华为开发者专家,华为产品云测专家,CSDN博客专家,CSDN商业化专家,阿里云专家博主,阿里云签约作者,腾讯云优秀博主,腾讯云内容共创官,掘金优秀博主,亚马逊技领云博主,51CTO博客专家等。近期荣誉2022年度博客之星TOP2,2023年度博客之星TOP2,2022年华为云十佳博主,2023年华为云十佳博主,2024年华为云十佳...
标题 详情
作者简介 愚公搬代码
头衔 华为云特约编辑,华为云云享专家,华为开发者专家,华为产品云测专家,CSDN博客专家,CSDN商业化专家,阿里云专家博主,阿里云签约作者,腾讯云优秀博主,腾讯云内容共创官,掘金优秀博主,亚马逊技领云博主,51CTO博客专家等。
近期荣誉 2022年度博客之星TOP2,2023年度博客之星TOP2,2022年华为云十佳博主,2023年华为云十佳博主,2024年华为云十佳博主等。
博客内容 .NET、Java、Python、Go、Node、前端、IOS、Android、鸿蒙、Linux、物联网、网络安全、大数据、人工智能、U3D游戏、小程序等相关领域知识。
欢迎 👍点赞、✍评论、⭐收藏

🚀前言

在现代前端开发中,构建高效、可维护的应用程序是每个开发者追求的目标。Vue.js 作为一个流行的前端框架,凭借其简洁的语法和灵活的设计理念,受到了广泛的欢迎。而 Vue CLI(命令行工具)则为我们提供了一个强大的工具集,旨在简化 Vue 项目的创建、开发和部署流程。

本篇文章将带你走进 Vue CLI 的世界,帮助你快速上手这一强大的开发工具。我们将介绍 Vue CLI 的基本概念、安装过程,以及如何使用它创建一个全新的 Vue 项目。通过详细的示例和逐步指导,你将学习到如何利用 Vue CLI 进行项目配置、插件管理、开发调试,以及如何使用其内置的脚手架工具来加速开发流程。

🚀一、VUE CLI工具入门

Vue CLI 是一个基于 Node.js 的命令行工具,用于快速创建 Vue.js 项目,并提供了开发、构建、测试和发布等一整套开发流程的自动化工具。它为 Vue.js 开发提供了很多便捷的功能和插件,使得开发人员能够更快速、更高效地搭建 Vue 项目。

接下来,我会介绍如何使用 Vue CLI 创建一个 Vue 项目,常见的配置和功能。

🔎1. 安装 Vue CLI

🦋1.1 安装 Node.js 和 npm

Vue CLI 是基于 Node.js 的,所以在安装 Vue CLI 之前,必须确保你的系统中已安装 Node.js 和 npm(Node.js 的包管理工具)。

  • 你可以访问 Node.js 官网 下载安装 Node.js。安装完成后,你可以通过命令行检查是否安装成功:

在这里插入图片描述

node -v
npm -v

在这里插入图片描述

如果你看到 Node.js 和 npm 的版本号,说明安装成功。

🦋1.2 安装 Vue CLI

Vue CLI 可以通过 npm 或 yarn 安装。在命令行中执行以下命令:

npm install -g @vue/cli

或者如果你使用的是 Yarn 包管理工具:

yarn global add @vue/cli

安装完成后,你可以检查是否成功安装 Vue CLI:

vue --version

在这里插入图片描述

如果输出版本号,说明 Vue CLI 安装成功。

🔎2. 创建一个 Vue 项目

🦋2.1 使用 Vue CLI 创建项目

执行以下命令,开始创建一个新的 Vue 项目:

vue create my-project

其中 my-project 是你项目的名称,可以替换为你喜欢的任何名字。

  • 执行命令后,Vue CLI 会询问你选择一些配置选项,通常会有两种选择:
    1. 默认配置:自动配置一些基本功能。
    2. 手动选择特性:可以自定义配置,选择自己需要的功能(如 TypeScript、Router、Vuex 等)。

例如:

? Please pick a preset: 
  default (Vue 3 + Babel + ESLint)
  Manually select features

选择 Manually select features 后,你可以选择需要的特性:

  • Babel: JavaScript 编译器,通常是必选项。
  • TypeScript: 如果你想使用 TypeScript,可以选择这个。
  • Router: Vue Router,用于路由管理,适用于 SPA(单页应用)。
  • Vuex: Vuex 是 Vue 的状态管理库。
  • CSS Pre-processors: 如果你需要使用 SASS、LESS 等 CSS 预处理器,可以选择。
  • PWA Support: 如果你需要支持渐进式 Web 应用(PWA),可以选择。
  • Linting/Formatting: 代码风格和格式化工具(如 ESLint、Prettier)。
  • Unit Testing: 单元测试。
  • E2E Testing: 端到端测试。

🦋2.2 完成创建

选择好配置后,Vue CLI 会安装依赖,并自动生成项目文件。安装完成后,你可以进入项目目录:

cd my-project

然后运行开发服务器:

pnpm run serve

访问 http://localhost:8080 就可以看到你的 Vue 项目运行起来了。

在这里插入图片描述

🔎3. 项目结构概览

Vue CLI 创建的项目结构大致如下:

my-project/
├── node_modules/        # 存放所有安装的依赖包
├── public/              # 公共资源文件夹,存放 index.html 和其他静态文件
│   └── index.html       # 入口 HTML 文件
├── src/                 # 项目的源代码
│   ├── assets/          # 存放静态资源(如图片、字体等)
│   ├── components/      # Vue 组件文件
│   ├── views/           # 页面视图组件
│   ├── App.vue          # 根组件
│   └── main.js          # 项目的入口文件
├── .gitignore           # Git 忽略文件
├── babel.config.js      # Babel 配置文件
├── package.json         # 项目描述文件,包含项目名称、依赖、脚本命令等
├── vue.config.js        # Vue CLI 配置文件(可选)
└── yarn.lock / package-lock.json # 依赖锁定文件

🦋3.1 重要文件

  • src/main.js:Vue 项目的入口文件,通常在这里初始化 Vue 实例,并挂载根组件 App.vue
  • src/App.vue:根组件,通常包含整个页面的基本布局。
  • public/index.html:应用的 HTML 模板。Vue 会将根组件挂载到该页面的 #app 元素中。

🔎4. 常见命令

在使用 Vue CLI 时,你会经常用到以下几个命令:

🦋4.1 启动开发服务器

npm run serve

这将启动一个本地开发服务器,默认情况下,应用将运行在 http://localhost:8080

🦋4.2 打包生产环境

npm run build

这将会构建一个优化后的生产版本,生成的文件会放在 dist/ 文件夹中。可以将这个文件夹内容部署到生产服务器上。

🦋4.3 运行单元测试

npm run test:unit

如果你选择了单元测试,Vue CLI 会为你配置 Jest 测试框架。

🦋4.4 运行端到端测试

npm run test:e2e

Vue CLI 默认集成了端到端测试工具 Cypress,如果你选择了端到端测试,可以使用该命令。

🦋4.5 linting 和格式化

npm run lint

这个命令会根据配置的 ESLint 和 Prettier 等工具检查和修复代码风格问题。

🔎5. 自定义配置(vue.config.js

虽然 Vue CLI 提供了开箱即用的配置,但你也可以通过项目根目录下的 vue.config.js 文件来修改默认的配置。常见的配置包括:

  • 修改开发服务器的端口、代理设置等。
  • 自定义 Webpack 配置,添加更多插件或修改现有的配置。

例如:

// vue.config.js
module.exports = {
  publicPath: './',  // 修改项目的公共路径
  devServer: {
    port: 3000,       // 设置开发服务器的端口
    proxy: 'http://localhost:4000'  // 设置请求代理
  },
  configureWebpack: {
    plugins: [
      // 自定义 Webpack 插件
    ]
  }
}

🔎6. 使用 Vue CLI 插件

Vue CLI 提供了大量的插件和功能,帮助你快速集成常见的开发工具。

🦋6.1 安装插件

使用 Vue CLI 也可以非常方便地安装和配置插件。例如,你可以通过以下命令来添加 Vue Router 或 Vuex:

vue add router
vue add vuex

这会自动安装并配置相应的插件,你不需要手动配置。

🦋6.2 删除插件

如果你想移除某个插件,可以使用:

vue remove router

这将会删除 router 插件及相关配置。

🔎7. 其他有用的命令

🦋7.1 检查项目依赖

npm audit

该命令可以帮助你检查项目的依赖是否存在安全漏洞。

🦋7.2 创建 Vue 组件

你可以手动创建 Vue 组件,也可以使用 Vue CLI 插件生成组件。以下命令可以生成一个新的 Vue 组件:

vue generate component MyComponent

🔎8. 总结

通过 Vue CLI,你可以快速搭建一个 Vue 项目,并根据需要选择所需的特性(如 Vue Router、Vuex、TypeScript 等)。它不仅提供了一个简单的配置过程,还集成了 Webpack 和其他常见工具,使得开发、构建、部署都变得非常便捷。

在实践中,你可以通过 vue.config.js 文件自定义项目配置,通过 Vue CLI 插件快速集成常见功能,提升开发效率。

🚀二、Vue CLI 工具中的 UI 创建项目

Vue CLI(Command Line Interface)是 Vue.js 官方提供的标准化脚手架工具,旨在简化 Vue 项目的创建和管理。Vue CLI 提供了命令行工具和图形用户界面(UI)两种方式来创建和管理项目。下面介绍如何使用 Vue CLI 的 UI 界面来创建项目。

🔎1. 安装 Vue CLI

首先,确保你已经安装了 Node.js 和 npm。然后,你可以通过 npm 全局安装 Vue CLI:

npm install -g @vue/cli

安装完成后,你可以通过以下命令检查 Vue CLI 是否安装成功:

vue --version

这条命令会输出 Vue CLI 的版本号,例如 @vue/cli 4.5.0

🔎2. 启动 Vue CLI UI

Vue CLI 提供了一个图形用户界面,可以通过以下命令启动:

vue ui

这条命令会在你的默认浏览器中打开 Vue CLI 的 UI 界面,同时在终端显示一个本地服务器地址(通常是 http://localhost:8000)。

在这里插入图片描述

🔎3. 创建新项目

在 Vue CLI 的 UI 界面中,你可以通过点击左侧导航栏的“项目管理”(Project Manager),然后点击右上角的“创建”(Create)按钮来创建一个新项目。

🦋3.1 选择项目存放路径

首先,你需要选择项目的存放路径。你可以选择一个现有的目录,也可以创建一个新目录来存放项目。

🦋3.2 填写项目基本信息

在选择好存放路径后,你需要填写项目的基本信息,包括:

  • 项目名称:你的项目名称。
  • 包管理器:npm 或 Yarn,选择你偏好的包管理工具。
  • 初始化 Git 仓库:是否在项目目录中初始化一个 Git 仓库。

在这里插入图片描述

🦋3.3 选择预设或手动配置

Vue CLI 提供了一些预设配置(preset),你可以直接选择一个预设,也可以选择手动配置项目。

  • 预设配置:Vue CLI 提供了一些常用的预设配置,你可以选择一个适合你的预设。
  • 手动配置:如果你选择手动配置,你可以根据需要选择以下选项:
    • Babel:JavaScript 编译器,可以将 ES6+ 转换为向后兼容的 JavaScript。
    • TypeScript:支持 TypeScript 编写代码。
    • Progressive Web App (PWA) Support:支持 PWA。
    • Router:Vue Router,用于处理前端路由。
    • Vuex:状态管理库。
    • CSS 预处理器:支持 Sass、Less、Stylus 等 CSS 预处理器。
    • Linter / Formatter:代码格式化和检查工具,比如 ESLint、Prettier。
    • Unit Testing:单元测试工具,如 Jest。
    • E2E Testing:端到端测试工具,如 Cypress、Nightwatch。

在这里插入图片描述

🦋3.4 配置详细选项

根据你选择的功能选项,Vue CLI 会进一步提供一些配置选项。例如,如果你选择了 Vue Router,它会询问你是否使用历史模式。如果你选择了 CSS 预处理器,它会让你选择具体的预处理器。

🦋3.5 保存预设

在完成所有配置后,你可以选择将当前配置保存为一个新的预设,以便在未来的项目中复用。

🦋3.6 创建项目

点击“创建项目”按钮后,Vue CLI 会开始创建项目,并自动安装所有必要的依赖。这个过程可能需要几分钟,具体时间取决于你的网络状况和项目配置。

🔎4. 管理项目

项目创建完成后,你可以在 Vue CLI 的 UI 界面中看到项目的详细信息,并进行各种管理操作。
在这里插入图片描述

🦋4.1 项目仪表盘

在项目仪表盘中,你可以看到项目的基本信息、依赖列表、最近的 Git 提交记录等。

🦋4.2 依赖管理

在依赖管理页面中,你可以查看、添加、更新或删除项目的依赖包。Vue CLI 提供了直观的界面,让你可以方便地管理项目依赖。

🦋4.3 配置管理

在配置管理页面中,你可以修改项目的各种配置,比如 Babel、ESLint、Vue Router 等。Vue CLI 提供了可视化的配置界面,让你可以轻松进行调整。

🦋4.4 插件管理

Vue CLI 支持插件系统,你可以在插件管理页面中查看、安装或卸载插件。Vue CLI 提供了丰富的插件生态系统,让你可以根据需要扩展项目功能。

🦋4.5 任务管理

在任务管理页面中,你可以执行常用的项目任务,比如启动开发服务器、构建生产版本、运行测试等。Vue CLI 提供了直观的界面,让你可以方便地执行和管理各种任务。

🔎5. 启动开发服务器

项目创建完成后,你可以通过 Vue CLI 的 UI 界面启动开发服务器。在任务管理页面中,找到“serve”任务,点击“运行”(Run)按钮。默认情况下,开发服务器会启动在 http://localhost:8080

你可以在浏览器中访问这个地址,查看你创建的项目。在开发过程中,Vue CLI 提供了热模块重载(HMR)功能,当你修改代码时,浏览器会自动更新,无需手动刷新页面。

在这里插入图片描述

🔎6. 构建生产版本

当你完成开发并准备发布项目时,可以通过 Vue CLI 的 UI 界面进行生产构建。在任务管理页面中,找到“build”任务,点击“运行”(Run)按钮。

Vue CLI 会自动打包项目,并生成优化后的生产版本。默认情况下,打包后的文件会输出到 dist/ 目录中。

🔎7. 总结

使用 Vue CLI 的 UI 界面创建和管理项目,提供了更直观和便捷的操作方式,特别适合不熟悉命令行的开发者。通过 Vue CLI 的 UI 界面,你可以:

  • 快速创建项目:通过图形界面一步步引导,轻松创建新项目。
  • 管理项目依赖:直观的依赖管理界面,方便查看和管理项目依赖。
  • 配置项目:可视化的配置管理,让你轻松调整项目配置。
  • 执行任务:通过任务管理界面,方便执行和管理常用的项目任务。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。