vue cli 3.0快速创建项目

时间:2024-01-15 23:59:32

本地安装vue-cli

前置条件

  • 更新npm到最新版本
  • 命令行运行:
  • npm install -g npm
    npm就自动为我们更新到最新版本

淘宝npm镜像使用方法

npm config set registry https://registry.npm.taobao.org
cnpm config set registry https://registry.npm.taobao.org
yarn config set registry https://registry.npm.taobao.org
配置后可通过下面方式来验证是否成功 :
npm config get registry

在日益流行前端工程化中,很多同学喜欢使用sass,然而node-sass的下载在国内是个老大难的问题,如果你不*,默认下载极大可能会失败。怎么办呢? 配置下 node-sass 的二进制包镜像地址就行了
yarn config set sass_binary_site http://cdn.npm.taobao.org/dist/node-sass -g

  • 使用 npm 全局安装 vue-cli :
  • npm i -g @vue/cli
    # OR
    yarn global add @vue/cli

创建项目

执行:
vue create my-project

此处有两个选择:

default (babel, eslint)默认套餐,提供babel和eslint支持

Manually select features自己去选择需要的功能,提供更多的特性选择。比如如果想要支持 TypeScript ,就应该选择这一项。

可以使用上下方向键来切换选项。如果只需要 babel 和 eslint 支持,那么选择第一项,就完事了,静静等待 vue 初始化项目。

vue-cli 内置支持了8个功能特性,可以多选:使用方向键在特性选项之间切换,使用空格键选中当前特性,使用 a 键切换选择所有,使用 i 键翻转选项。

对于每一项的功能,此处做个简单描述:

TypeScript 支持使用 TypeScript 书写源码

Progressive Web App (PWA) Support PWA 支持。

Router 支持 vue-router 。

Vuex 支持 vuex 。

CSS Pre-processors 支持 CSS 预处理器。

Linter / Formatter 支持代码风格检查和格式化。

Unit Testing 支持单元测试。

E2E Testing 支持 E2E 测试。

我选择了 Router,Vuex,CSS Pre-processors,Linter / Formatter

按住enter进入下一步,接下来都是对之前每项选项的更详细的选择。

css选择SCSS/SASS
Linter / Formatter选择prettier

这一步就是要选择配置文件的位置了。对于 Babel 、 PostCSS 等,都可以有自己的配置文件: .babelrc 、 .postcssrc 等等,同时也可以把配置信息放在 package.json 里面。此处出于对编辑器( Visual Studio Code )的友好支持(编辑器一般默认会在项目根目录下

寻找配置文件),选择把配置文件放在外面,选择 In dedicated config files

待补充

Save this as a preset for future projects?这个就是问要不要把当前的这一系列选项配置保存起来,方便下一次创建项目时复用。选择y。

选完之后, vue-cli 就根据前面选择的内容,开始初始化项目了。

启动项目


初始完之后,进入到项目根目录:
cd my-project
启动项目:
npm run serve
稍等一会儿,可以看到自动在浏览器中打开了

安装PostCSS插件

  • 通过Vue-cli构建的项目,在项目的根目录下有一个.postcssrc.js,默认情况下已经有了:
odule.exports = {
plugins: {
autoprefixer: {}
}
}

配置成

odule.exports = {
plugins: {
"postcss-import":{},
"postcss-url":{},
"autoprefixer": {}
}
}

安装postcss-import和postcss-url插件

$ npm install postcss-import和$ npm install postcss-url

postcss-import相关配置点击这里。主要功有是解决@import引入路径问题。使用这个插件,可以让你很轻易的使用本地文件、node_modules或者web_modules的文件。这个插件配合postcss-url让你引入文件变得更轻松。

postcss-url相关配置可以点击这里。该插件主要用来处理文件,比如图片文件、字体文件等引用路径的处理。在Vue项目中,vue-loader已具有类似的功能,只需要配置中将vue-loader配置进去。

autoprefixer插件是用来自动处理浏览器前缀的一个插件。如果你配置了postcss-cssnext,其中就已具备了autoprefixer的功能。在配置的时候,未显示的配置相关参数的话,表示使用的是Browserslist指定的列表参数,你也可以像这样来指定last 2 versions 或者 >

5%。如此一来,你在编码时不再需要考虑任何浏览器前缀的问题,可以专心撸码。这也是PostCSS最常用的一个插件之一。

要使用

安装成功后,在项目根目录下的package.json文件中,可以看到新安装的依赖包:

"dependencies": {
"cssnano": "^3.10.0",
"postcss-aspect-ratio-mini": "^0.0.2",
"postcss-cssnext": "^3.1.0",
"postcss-import": "^11.1.0",
"postcss-px-to-viewport": "^0.0.3",
"postcss-url": "^7.3.2",
"postcss-viewport-units": "^0.1.4",
"postcss-write-svg": "^3.0.1",
"vue": "^2.5.16",
"vue-router": "^3.0.1",
"vuex": "^3.0.1"
},

接下来在.postcssrc.js文件对新安装的PostCSS插件进行配置:

odule.exports = {
plugins: {
"postcss-import": {},
"postcss-url": {},
//"autoprefixer": {},
"postcss-aspect-ratio-mini": {},
"postcss-write-svg": {
utf8: false
},
"postcss-cssnext": {},
"postcss-px-to-viewport": {
viewportWidth: , //视窗的宽度,对应的是我们设计稿的宽度,一般是750
viewportHeight: , //视窗的高度,根据750设备的宽度来置顶,一般指定1334,也可以不配置
unitPrecision: , //指定'px'转换为视窗单位值的小数位数(很多时候无法整除)
viewportUnit: 'vw', //指定需要转换成的视窗单位,建议使用vw
selectorBlackList: ['.ignore', '.hairlines', '.g-vw-no'], //指定不转行为视窗单位的类,可以自定义,可以无限添加,建议定义一至两个通用的类名
minPixeValue: , //小于或等于'1px'不转换为视窗单位,你也可以设置为你想要的值
mediaQuery: false //允许在媒体查询中转换'px'
},
"postcss-viewport-units": {},
"cssnano": {
preset: "advanced",
autoprefixer: false,
"postcss-zindex": false
}
}
}

由于配置文件修改了,所以重新跑一下npm run dev。项目就可以正常看到了。接下来简单的介绍一下后面安装的几个插件的作用。

postcss-cssnext
postcss-cssnext其实就是cssnext。该插件可以让我们使用CSS未来的特性,其会对这些特性做相关的兼容性处理。其包含的特性主要有:
有关于cssnext的每个特性的操作文档,可以点击这里浏览。

cssnano
cssnano主要用来压缩和清理CSS代码。在Webpack中,cssnano和css-loader捆绑在一起,所以不需要自己加载它。不过你也可以使用postcss-loader显式的使用cssnano。有关于cssnano的详细文档,可以点击这里获取。

在cssnano的配置中,使用了preset: "advanced",所以我们需要另外安装:

cssnano集成了一些其他的PostCSS插件,如果你想禁用cssnano中的某个插件的时候,可以像下面这样操作:

"cssnano": {
autoprefixer: false,
"postcss-zindex": false
}

上面的代码把autoprefixer和postcss-zindex禁掉了。前者是有重复调用,后者是一个讨厌的东东。只要启用了这个插件,z-index的值就会重置为1。这是一个天坑,***千万记得将postcss-zindex设置为false***。
postcss-px-to-viewport

postcss-px-to-viewport插件主要用来把px单位转换为vw、vh、vmin或者vmax这样的视窗单位,也是vw适配方案的核心插件之一。

在配置中需要配置相关的几个关键参数:

"postcss-px-to-viewport": {
viewportWidth: , // 视窗的宽度,对应的是我们设计稿的宽度,一般是750
viewportHeight: , // 视窗的高度,根据750设备的宽度来指定,一般指定1334,也可以不配置
unitPrecision: , // 指定`px`转换为视窗单位值的小数位数(很多时候无法整除)
viewportUnit: 'vw', // 指定需要转换成的视窗单位,建议使用vw
selectorBlackList: ['.ignore', '.hairlines'], // 指定不转换为视窗单位的类,可以自定义,可以无限添加,建议定义一至两个通用的类名
minPixelValue: , // 小于或等于`1px`不转换为视窗单位,你也可以设置为你想要的值
mediaQuery: false // 允许在媒体查询中转换`px`
}

目前出视觉设计稿,我们都是使用750px宽度的,那么100vw = 750px,即1vw = 7.5px。那么我们可以根据设计图上的px值直接转换成对应的vw值。在实际撸码过程,不需要进行任何的计算,直接在代码中写px,比如:

.test {
border: .5px solid black;
border-bottom-width: 4px;
font-size: 14px;
line-height: 20px;
position: relative;
}
[w--] {
width: 188px;
} 编译出来的CSS: .test {
border: .5px solid #;
border-bottom-width: .533vw;
font-size: .867vw;
line-height: .667vw;
position: relative;
}
[w--] {
width: .067vw;
}

不想要把px转换为vw的时候,首先在对应的元素(html)中添加配置中指定的类名.ignore或.hairlines(.hairlines一般用于设置border-width:0.5px的元素中):

<div class="box ignore"></div>

写CSS的时候:

ignore {
margin: 10px;
background-color: red;
}
.box {
width: 180px;
height: 300px;
}
.hairlines {
border-bottom: .5px solid red;
}

编译出来的CSS:

.box {
width: 24vw;
height: 40vw;
}
.ignore {
margin: 10px; /*.box元素中带有.ignore类名,在这个类名写的`px`不会被转换*/
background-color: red;
}
.hairlines {
border-bottom: .5px solid red;
}

上面解决了px到vw的转换计算。那么在哪些地方可以使用vw来适配我们的页面。根据相关的测试:

容器适配,可以使用vw
文本的适配,可以使用vw
大于1px的边框、圆角、阴影都可以使用vw
内距和外距,可以使用vw
postcss-aspect-ratio-mini
postcss-aspect-ratio-mini主要用来处理元素容器宽高比。在实际使用的时候,具有一个默认的结构

<div aspectratio>
<div aspectratio-content></div>
</div>

在实际使用的时候,你可以把自定义属性aspectratioaspectratio-content换成相应的类名,比如:

<div class="aspectratio">
<div class="aspectratio-content"></div>
</div>

我个人比较喜欢用__自定义属性__,它和类名所起的作用是同等的。结构定义之后,需要在你的样式文件中添加一个统一的宽度比默认属性:

[aspectratio] {
position: relative;
}
[aspectratio]::before {
content: '';
display: block;
width: 1px;
margin-left: -1px;
height: ;
}
/*aspectratio-content存放内容,*填满,利用伪元素::before和::after来撑开容器*/
[aspectratio-content] {
position: absolute;
top: ;
left: ;
right: ;
bottom: ;
width: %;
height: %;
}

如果我们想要做一个188:246188是容器宽度,246是容器高度)这样的比例容器,只需要这样使用:

[w--] {
aspect-ratio: '188:246';
}

有一点需要特别注意:aspect-ratio属性不能和其他属性写在一起,否则编译出来的属性只会留下aspect-ratio的值,比如:

<div aspectratio w-- class="color"></div>

编译前的CSS如下:

[w--] {
width: 188px;
background-color: red;
aspect-ratio: '188:246';
}

编译之后:

[w--]:before {
padding-top: 130.85106382978725%;
}

主要是因为在插件中做了相应的处理,不在每次调用aspect-ratio时,生成前面指定的默认样式代码,这样代码没那么冗余。所以在使用的时候,需要把widthbackground-color分开来写:

[w--] {
width: 188px;
background-color: red;
}
[w--] {
aspect-ratio: '188:246';
}

这个时候,编译出来的CSS就正常了:

[w--] {
width: .067vw;/*撑开宽度*/
background-color: red;
}
[w--]:before {
padding-top: 130.85106382978725%;/*撑开高度*/
}

喜欢的读者点个赞哦~后续持续跟新哦.

相信很多人在刚接触前端或者中期时候总会遇到一些问题及瓶颈期,如学了一段时间没有方向感或者坚持不下去一个人学习枯燥乏味有问题也不知道怎么解决,对此我整理了一些资料 喜欢我的文章想与更多资深大牛一起讨论和学习的话 欢迎加入我的学习交流群907694362