uni-app vue-cli项目 uView安装及配置

一、说明

uView安装有下载安装和npm安装两种方式，使用的是npm安装。

二、步骤

1、安装SCSS

uView依赖SCSS，您必须要安装此插件，否则无法正常运行。

// 安装node-sass
npm i node-sass -D

// 安装sass-loader
npm i sass-loader -D

2、对uView进行npm安装

// 安装
npm install uview-ui

3、引入uView主JS库

在项目根目录中的main.js中，引入并使用uView的JS库，注意这两行要放在import Vue之后。

// main.js
import uView from "uview-ui";
Vue.use(uView);

4、引入uView的全局SCSS主题文件

在项目根目录的uni.scss中引入此文件。

/* uni.scss */
@import 'uview-ui/theme.scss';

5、在App.vue中引入uView基础样式

<style lang="scss">
	/* 注意要写在第一行，同时给style标签加入lang="scss"属性 */
	@import "uview-ui/index.scss";
</style>

6、配置easycom组件模式

此配置需要在项目根目录的pages.json中进行。uni-app为了调试性能的原因，修改easycom规则不会实时生效，配置完后，重新编译项目才能正常使用uView的功能。

// pages.json
{
	"easycom": {
		"^u-(.*)": "uview-ui/components/u-$1/u-$1.vue"
	},
	
	// 此为本身已有的内容
	"pages": [
		// ......
	]
}

遇到问题：

执行完上面的步骤后，重新编译时报错。

解决问题：

经过排查，应该是sass-loader的版本过高问题。在package.json文件中修改sass-loader，从12.x.x（忘记具体是多少了）改成10.1.0，执行npm install安装依赖，然后重新编译项目，编译成功，可正常使用uView组件。

// package.json 
"node-sass": "^6.0.1",
"sass-loader": "^10.1.0",    // 修改后

记录于2021/09/03。