uView Plus + Vue3 + TypeScript + UniApp 正确引入 UnoCSS(避坑版)

一、前言

在 Vue3 项目里,每次写样式都要:新建 class,切到 css,写完再切回来,久而久之,手已经不想动了。这时候你就会开始怀念一句话:

"如果 Tailwind 能用在 uni-app 就好了。"

于是你发现了 UnoCSS。

然后------

开始踩坑了。

二、实现完整代码

javascript 复制代码
pnpm add unocss@0.55.7 -D

1.创建 uno.config.ts文件,放在 项目根目录(不是 src)。

javascript 复制代码
import {
  defineConfig,
  presetUno,
  presetAttributify,
  presetIcons,
} from 'unocss'

export default defineConfig({
  presets: [
    presetUno(),
    presetAttributify(),
    presetIcons(),
  ],
})

2.配置 vite.config.ts

javascript 复制代码
import { defineConfig } from 'vite'
import uni from '@dcloudio/vite-plugin-uni'
import UnoCSS from 'unocss/vite'

export default defineConfig({
  plugins: [
    uni(),
    UnoCSS(),
  ],
})

3.main.ts文件引入unocss

javascript 复制代码
import "uno.css";

三、为什么选择 UnoCSS?

unocss、Tailwind、preset-weapp这么多版本为什么选择UnoCSS,因为我在uView Plus文档里面看到 uView Plus默认把单位统一成 px 了,所以的选择是UnoCSS,

一句话版本:

Tailwind 太重,preset-weapp 不合适,UnoCSS 刚刚好。

Tailwind 的问题

  • 体积大
  • 配置复杂
  • 在 uni-app 里体验一般
  • H5 能用,小程序各种限制
    结论:
    不是不能用,是不想折腾。

unocss-preset-weapp 的问题

很多博客会推荐:

javascript 复制代码
pnpm add unocss unocss-preset-weapp -D

但如果你用的是 uView Plus,这里要打一个 ❌。

原因很关键:
uView Plus 已经把单位默认单位设置是px
而 unocss-preset-weapp 的核心目标是:

  • 适配微信小程序
  • 默认 rpx
  • 做样式转换

结果就是:

preset-weapp 想帮你转单位

uView Plus 已经帮你转过了

两边一碰头 ------ 单位体系直接打架

所以在 uView Plus 项目中:不推荐使用 unocss-preset-weapp

正确选型结论

技术栈 推荐方案
uView Plus + UniApp + H5 ✅ UnoCSS
纯微信小程序 ✅ UnoCSS + preset-weapp
Tailwind 原教旨 ❌ 不推荐

四、选择 UnoCSS版本(稳定版)

这里不要追最新版本,uni-app + Vite 对新版本支持并不总是同步。

推荐版本:

javascript 复制代码
pnpm add unocss@0.55.7 -D

这个版本在:

  • uni-app
  • Vite
  • Vue3
  • H5

组合下是最稳的。

相关推荐
用户938515635076 小时前
从零在浏览器里跑 DeepSeek-R1:WebGPU + Transformers.js 全链路实战(三)
前端·react.js·typescript
Sterting8 小时前
第9课 Vue Router 路由
前端·vue.js
满栀5859 小时前
vue动态路由效果
前端·javascript·vue.js·前端框架·vue
心运软件10 小时前
SpringBoot+ Vue校园社团管理平台的完整架构设计
vue.js·后端
jjw_zyfx11 小时前
css vue vite实现闪烁的呼吸效果
javascript·css·vue.js
执子念的飞鱼11 小时前
File Viewer 进入 2K 节点后,我更在意这 3 条回归
前端·typescript
mONESY11 小时前
TypeScript 面试高频:type 与 interface 到底怎么选?
typescript
浅水壁虎12 小时前
vue基础(第四章 Pinia)
前端·javascript·vue.js
2501_9160074712 小时前
Bundle ID 注册与管理 App ID 创建指南 命名规则 权限开关与删除注意事项
android·ios·小程序·https·uni-app·iphone·webview
学习星球13 小时前
Vue 3 实战:拆解 RealWorld 项目
前端·vue.js