vue-cli的使用方法

发表于 | 分类于 ， | 阅读次数:

vue-cli这个构建工具大大降低了webpack的使用难度，支持热更新，有webpack-dev-server的支持，相当于启动了一个请求服务器，给你搭建了一个测试环境，只关注开发就OK。

安装vue-cli

  1. 使用npm(需要安装node环境)全局安装webpack npm install webpack -g，安装完毕后可以webpack -v检查webpack的版本号，有显示的话表示成功安装

注意：webpack4.x开始，需要安装webpack-cli依赖，命令npm i webpack webpack-cli -g

  1. 全局安装vue-cli，命令npm i vue-cli -g，安装成功vue -V（v大写）检查版本号，判断是否安装成功。打开node_modules可以看到vue-cli文件夹

用vue-cli初始化项目

  1. 新建文件夹test，打开命令行工具，cd进入该文件夹输入：
1
vue init webpack TodoList

TodoList是自定义的项目名称，命令执行后，会在test下生成一个该名称命名的项目文件夹

image-20181019120520437

输入命令后，会跳出几个选项让你回答：

  • Project name (baoge)： —–项目名称，直接回车，按照括号中默认名字（注意这里的名字不能有大写字母，如果有会报错Sorry, name can no longer contain capital letters），阮一峰老师博客为什么文件名要小写 ，可以参考一下。
  • Project description (A Vue.js project)： —-项目描述，也可直接点击回车，使用默认名字
  • Author ()： —-作者，输入你的大名
    接下来会让用户选择：
  • Runtime + Compiler: recommended for most users 运行加编译，既然已经说了推荐，就选它了
    Runtime-only: about 6KB lighter min+gzip, but templates (or any Vue-specificHTML) are ONLY allowed in .vue files - render functions are required elsewhere 仅运行时，已经有推荐了就选择第一个了
  • Install vue-router? (Y/n) 是否安装vue-router，这是官方的路由，大多数情况下都使用，这里就输入“y”后回车即可。
  • Use ESLint to lint your code? (Y/n) 是否使用ESLint管理代码，ESLint是个代码风格管理工具，是用来统一代码风格的，一般项目中都会使用。
    接下来也是选择题Pick an ESLint preset (Use arrow keys) 选择一个ESLint预设，编写vue项目时的代码风格，standard比较松散，所以可以直接y回车
  • Set up unit tests (Y/n) 是否安装单元测试，我选择安装y回车
  • Setup e2e tests with Nightwatch(Y/n)? 是否安装e2e测试 ，我选择安装y回车

回答完毕后上图就开始构建项目了。

  1. 配置完成后，可以看到目录下多了一个项目文件夹TodoList，cd进入这个文件夹，安装依赖：

    1
    npm i

    ( 如果安装速度太慢。可以安装淘宝镜像，打开命令行工具，输入：
     npm install -g cnpm --registry=https://registry.npm.taobao.org
     然后使用cnpm来安装 )

    npm install ：

    安装所有的模块，如果是安装具体的某个模块，在install 后面输入模块的名字即可。而只输入install就会按照项目的根目录下的package.json文件中依赖的模块安装（这个文件里面是不允许有任何注释的），每个使用npm管理的项目都有这个文件，是npm操作的入口文件。

    因为是初始项目，还没有任何模块，所以用npm install 安装所有的模块。安装完成后，目录中会多出来一个node_modules文件夹，这里放的就是所有依赖的模块。

    解释下每个文件夹代表的意思(仔细看一下这张图）：

    img

启动项目

Cd进入TodoList文件夹，执行命令：

1
npm run dev

可能遇到的问题

1.浏览器打开后，没有加载出页面

​ 可能是本地8080端口占用，可以修改配置文件config里面的index.js

  1. 本地调试时，打包遇到问题

    建议将配置文件config里面的index.js的build 里的assetsPublicPath的路径前缀修改为 ‘ ./ ‘（开始是 ‘ / ‘），因为打包之后，外部引入 js 和 css 文件时，如果路径以 ‘ / ‘ 开头，在本地是无法找到对应文件的（服务器上没问题）。所以如果需要在本地打开打包后的文件，就得修改文件路径

  2. 在进行vue页面调试时，建议去谷歌商店下载一个vue-tool扩展程序。

vue-cli的webpack配置分析

  • 从package.json可以看到开发和生产环境的入口。

    image-20181019130507720

  • 可以看到dev中的设置，build/webpack.dev.conf.js，该文件是开发环境中webpack的配置入口。

  • 在webpack.dev.conf.js中出现webpack.base.conf.js，这个文件是开发环境和生产环境，甚至测试环境，这些环境的公共webpack配置。可以说，这个文件相当重要。

  • 还有config/index.js 、build/utils.js 、build/build.js等，具体请看这篇介绍：
    vue-cli webpack配置分析

打包上线

注意，自己的项目文件都需要放到 src 文件夹下。
在项目开发完成之后，可以输入 npm run build 来进行打包工作。

另：

1
2
3
4
5
6
7
8
9
1.npm 开启了npm run dev以后怎么退出或关闭？
ctrl+c

2.--save-dev
自动把模块和版本号添加到模块配置文件package.json中的依赖里devdependencies部分

3. --save-dev 与 --save 的区别
--save     安装包信息将加入到dependencies（生产阶段的依赖）
--save-dev 安装包信息将加入到devDependencies（开发阶段的依赖），所以开发阶段一般使用它

打包完成后，会生成 dist 文件夹，如果已经修改了文件路径，可以直接打开本地文件查看。
项目上线时，只需要将 dist 文件夹放到服务器就行了。