@vue/cli(vue脚手架)超详细教程

本文介绍了@vue/cli的安装与使用,包括创建项目、定制配置、文件结构剖析,并重点讲解了如何利用Vue CLI进行组件开发。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

1.@vue/cli 脚手架介绍

@vue/cli是Vue官方提供的一个全局模块包(得到vue命令), 此包用于创建脚手架项目

1.1 @vue/cli的好处

  • 开箱即用

    0配置webpack

    babel支持

    css, less支持

    开发服务器支持

 1.2  @vue/cli安装

  • 全局安装命令

yarn global add @vue/cli
# OR
npm install -g @vue/cli
  • 查看vue脚手架版本

vue -V

 1.3 @vue/cli 创建项目启动服务

1.创建项目

# vue和create是命令, vuecli-demo是文件夹名
vue create vuecli-demo

2.选择模板

 3.选择用什么方式下载脚手架项目需要的依赖包

回车等待生成项目文件夹+文件+下载必须的第三方包

4.进入脚手架项目下, 启动内置的热更新本地服务器

cd vuecil-demo

yarn serve

 只要看到绿色的就代表你成功了

 按住ctrl点击localhost地址打开浏览器

2.@vue/cli 目录和代码分析

vuecil-demo        # 项目目录
    ├── node_modules # 项目依赖的第三方包
    ├── public       # 静态文件目录
      ├── favicon.ico# 浏览器小图标
      └── index.html # 单页面的html文件(网页浏览的是它)
    ├── src          # 业务文件夹
      ├── assets     # 静态资源
        └── logo.png # vue的logo图片
      ├── components # 组件目录
        └── HelloWorld.vue # 欢迎页面vue代码文件 
      ├── App.vue    # 整个应用的根组件
      └── main.js    # 入口js文件
    ├── .gitignore   # git提交忽略配置
    ├── babel.config.js  # babel配置
    ├── package.json  # 依赖包列表
    ├── README.md    # 项目说明
	└── yarn.lock    # 项目包版本锁定和缓存地址

 主要文件及含义

node_modules下都是下载的第三方包
public/index.html – 浏览器运行的网页
src/main.js – webpack打包的入口文件
src/App.vue – vue项目入口页面
package.json – 依赖包列表文件

3. @vue/cli 项目架构了解

2.2 @vue/cli 自定义配置

项目中没有webpack.config.js文件,因为@vue/cli用的vue.config.js

src并列处新建vue.config.js:

/* 覆盖webpack的配置 */
module.exports = {
  devServer: { // 自定义服务配置
    open: true, // 自动打开浏览器
    port: 3000
  }
}

2.3 @vue/cli 单vue文件讲解

Vue推荐采用.vue文件来开发项目

template里只能有一个根标签

vue文件-独立模块-作用域互不影响

style配合scoped属性, 保证样式只针对当前template内标签生效

vue文件配合webpack, 把他们打包起来插入到index.html

<!-- template必须, 只能有一个根标签, 影响渲染到页面的标签结构 -->
<template>
  <div>欢迎使用vue</div>
</template>

<!-- js相关 -->
<script>
export default {
  name: 'App'
}
</script>

<!-- 当前组件的样式, 设置scoped, 可以保证样式只对当前页面有效 -->
<style scoped>
</style>

最终: Vue文件配合webpack, 把他们打包起来插入到index.html, 然后在浏览器运行

以上就完成了vue的安装和对基本项目文件和功能的了解 

### @vue/cli-service 的使用方法与常见问题 #### 一、@vue/cli-service 简介 `@vue/cli-service` 是 Vue CLI 创建的项目的开发服务器和服务工具的核心包。它提供了构建、运行开发服务器以及生产环境打包等功能[^1]。 #### 二、错误处理案例分析 当遇到 `Error: @vitejs/plugin-vue requires vue (>=3.2.13)` 错误时,这通常是因为项目依赖树中缺少必要的 Vue 版本或其编译器插件[@vue/compiler-sfc][^2]。以下是解决方案: - **确认版本兼容性**:确保当前使用的 Vue 版本满足最低要求(即 >=3.2.13),可以通过以下命令检查: ```bash npm list vue ``` - **安装缺失依赖项**:如果发现未安装必要组件,则可以尝试通过以下方式修复: ```bash npm install vue@latest --save-dev npm install @vue/compiler-sfc --save-dev ``` #### 三、全局卸载并重装 Vue CLI 工具链 对于某些情况下无法正常工作或者存在冲突的情况,可能需要完全移除现有 Vue CLI 并重新安装指定版本。具体操作如下所示[^3]: - 卸载旧版 Vue CLI: ```bash npm remove -g @vue/cli ``` - 使用 cnpm 安装特定版本(如需回退至稳定版 4.x 可按此步骤): ```bash cnpm install -g @vue/cli@4.5.15 ``` - 验证安装状态: ```bash vue -V ``` #### 四、不借助 Vue CLI 手动搭建 Webpack + Vue 项目 如果不希望通过官方脚手架来初始化工程结构,也可以考虑手动配置 webpack 和其他相关模块完成基础框架建设[^4]。这种做法适合高级开发者自定义需求场景下应用灵活调整策略: - 初始化 package.json 文件: ```bash npm init -y ``` - 添加所需库支持: ```bash npm install vue vue-loader css-loader style-loader babel-core babel-loader --save-dev ``` - 编写简单的 Webpack 配置文件(webapck.config.js),例如: ```javascript const path = require('path'); module.exports = { entry: './src/main.js', output: { filename: 'bundle.js', path: path.resolve(__dirname, 'dist') }, resolve: { alias: { 'vue$': 'vue/dist/vue.esm.js' } }, module: { rules: [ { test: /\.vue$/, loader: 'vue-loader' }, { test: /\.(css|scss)$/, use: ['style-loader', 'css-loader'] } ] } }; ``` #### 结论 以上介绍了关于如何排查和解决围绕 `@vue/cli-service` 出现的一些典型问题及其替代方案。无论是升级依赖还是切换到更底层的手工设置流程都各有优劣,请依据实际业务背景做出合理抉择。
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值