更新记录

0.6.24（2026-11-06） 下载此版本

BREAKING CHANGES | 破坏性变更

• theme: themes 列表现在只包含你显式声明的主题，内置主题不再自动追加到列表首位。升级后如果依赖「官方蓝始终存在」的行为（例如切回官方蓝的按钮、按索引取主题），需显式声明一项 { name: BASE_THEME_NAME, color: {} }，否则主题数量会比旧版本少一项。
• theme: 暗黑模式下 css 与 darkCss 改为按 key 合并。旧版本只要 darkCss 非空就会整体忽略 css，导致 css 里的变量在暗黑下全部失效；如果此前恰好依赖这种「暗黑下屏蔽 css 变量」的效果，需要把要屏蔽的变量写进 darkCss 并置为空字符串。其余场景无需改动，升级后自定义变量在暗黑下反而更完整。

Features | 新功能

• theme: 主题对象新增 css / darkCss，可声明任意自定义 CSS 变量（品牌渐变、圆角、高度等），随主题与暗黑模式自动注入，页面通过 var() 或 useTheme().cssVars 读取
• theme: 新增顶层共享 css / darkCss，一次声明即可广播到全部主题，主题自身的同名 key 优先
• theme: 支持扁平单主题写法，颜色令牌与 css / darkCss / darkColor / name / label / description 写在同一个对象里
• theme: 无条件注入基线变量 --u-background / --u-surface / --u-text（亮色、暗黑各一套），任何主题都能直接使用
• theme: 新增 BASE_THEME_NAME 常量与 SingleTheme 类型，初始化入口统一由 resolveThemeOption 归一化三种主题配置形态

Bug Fixes | Bug 修复

• theme: 修复暗黑模式下 darkCss 非空时整体忽略 css，导致自定义变量在暗黑下丢失的问题
• theme: 修复默认主题名指向不存在的主题时 config.defaultTheme 留下脏值的问题
• theme: 修复主题 label 显式传空字符串时被基线 label 覆盖的问题
• theme: 修复 install 中调试模式配置晚于主题初始化，初始化阶段的告警无法按配置输出的问题

0.6.23（2026-11-04） 下载此版本

Features | 新功能

• u-link: 新增小程序平台复制链接成功和失败事件的发出（#187） (37355b6)

• uView Pro X 组件库已正式发布，全面支持 uni-app x 蒸汽模式（Vapor），详细查看：插件市场

0.6.22（2026-10-30） 下载此版本

喜讯

• uView Pro X: 支持 uni-app x 的 uView Pro X 组件库已正式上线，全面支持蒸汽模式（Vapor），详细查看：插件市场

Features | 新功能

• u-input: input 组件新增后置插槽支持图标与按钮 (120d52d)

平台兼容性

uni-app(4.07)

其他

uView Pro

uni-app Vue3 多平台快速开发的 UI 框架

说明

uView Pro，是全面支持 Vue3.0、TypeScript 的 uni-app 生态框架，uView Pro 的基线版本是基于 uView 1.8.8 版本，使用 TypeScript 完全重构，已覆盖 Android、iOS、鸿蒙以及微信/头条/支付宝等主流小程序平台，真正实现“一套代码，多端运行”，支持多主题系统、暗黑模式与国际化（i18n）。

官方文档：https://uviewpro.cn

快速启动模板：https://starter.uviewpro.cn

🎉喜讯

支持 uni-app x 的 uView Pro X 组件库已正式上线，全面支持蒸汽模式（Vapor），详细查看：

• 插件市场：https://ext.dcloud.net.cn/plugin?name=uview-pro-x

• 官方文档：https://x.uviewpro.cn

特性

• 兼容安卓，iOS，微信小程序，H5，QQ 小程序，百度小程序，支付宝小程序，头条小程序
• 70+精选组件，功能丰富，多端兼容，让您快速集成，开箱即用
• 众多贴心的 JS 利器，让您飞镖在手，召之即来，百步穿杨
• 众多的常用页面和布局，让您专注逻辑，事半功倍
• 详尽的文档支持，现代化的演示效果
• 按需引入，精简打包体积

手机预览

您可以通过微信或手机浏览器扫描以下二维码，查看最佳的演示效果。

微信小程序 （微信扫码）	支付宝小程序 （支付宝扫码）	H5 （浏览器扫码）	安卓 （浏览器扫码）	鸿蒙 （鸿蒙5.0+扫码）

运行示例工程，请下载源码后，在项目根目录执行以下命令：

pnpm install
pnpm dev

链接

• Github
• Gitee
• 官方文档
• 更新日志

交流反馈

欢迎通过各种方式来交流反馈，让 uView Pro 更好的为大家服务：

欢迎交流反馈

捐赠 uView Pro

开源不易，如果您认为 uView Pro 帮到了您的开发工作，您可以捐赠 uView Pro：

欢迎捐赠留名

关于 PR

我们非常乐意接受各位的优质 PR，但在此之前我希望您了解 uView Pro 是一个需要兼容多个平台的（小程序、h5、iOS App、Android App）包括 nvue 页面、vue 页面。

所以希望在您修复 bug 并提交之前尽可能的去这些平台测试一下兼容性。最好能携带测试截图以方便审核。非常感谢！

安装配置

uView Pro 支持 npm 和 uni_modules 两种主流安装方式，配置方式高度一致。无论采用哪种方式，均可通过 easycom 实现组件自动引入，极大提升开发效率。以下为统一的配置说明：

1. 安装 uView Pro

• npm 安装：

npm install uview-pro
# 或
yarn add uview-pro
# 或
pnpm add uview-pro

• uni_modules 安装：

通过 HBuilderX 插件市场或手动下载，将 uView Pro 放入 uni_modules 目录。

插件市场：https://ext.dcloud.net.cn/plugin?name=uview-pro

2. 引入 uView Pro 主库

在 main.ts 中引入并注册 uView Pro：

import { createSSRApp } from 'vue';
// npm 方式
import uViewPro from 'uview-pro';
// uni_modules 方式
// import uViewPro from "@/uni_modules/uview-pro";

export function createApp() {
    const app = createSSRApp(App);
    app.use(uViewPro);
    return {
        app
    };
}

3. 引入全局样式

在 uni.scss 中引入主题样式：

/* npm 方式 */
@import 'uview-pro/theme.scss';
/* uni_modules 方式 */
/* @import "@/uni_modules/uview-pro/theme.scss"; */

在 App.vue 首行引入基础样式：

<style lang="scss">
  /* npm 方式 */
  @import "uview-pro/index.scss";
  /* uni_modules 方式 */
  /* @import "@/uni_modules/uview-pro/index.scss"; */
</style>

4. 配置 easycom 自动引入组件

在 pages.json 中配置 easycom 规则，实现组件自动引入：

{
    "easycom": {
        "autoscan": true,
        "custom": {
            // npm 方式
            "^u-(.*)": "uview-pro/components/u-$1/u-$1.vue"
            // uni_modules 方式
            // "^u-(.*)": "@/uni_modules/uview-pro/components/u-$1/u-$1.vue"
        }
    },
    "pages": []
}

温馨提示

• 1.修改 easycom 规则后需重启 HX 或重新编译项目。
• 2.请确保 pages.json 中只有一个 easycom 字段，否则请自行合并多个规则。
• 3.一定要放在 custom 内，否则无效。

5. Volar 类型提示支持

如需在 CLI 项目中获得 Volar 的全局类型提示，请在 tsconfig.json 中添加：

{
    "compilerOptions": {
        // npm 方式
        "types": ["uview-pro/types"]
        // uni_modules 方式
        // "types": ["@/uni_modules/uview-pro/types"]
    }
}

HBuilderX 项目暂不支持 tsconfig.json 的 types 配置，CLI 项目推荐配置以获得最佳 TS 体验。

6. 组件使用

配置完成后，无需 import 和 components 注册，可直接在 SFC 中使用 uView Pro 组件：

<template>
    <u-button type="primary">按钮</u-button>
</template>

请通过快速上手了解更详细的内容

贡献者

版权信息

uView Pro 遵循MIT开源协议，意味着您无需支付任何费用，也无需授权，即可将 uView Pro 应用到您的产品中。

致谢

uView Pro 基于 uView UI 1.8.8 进行 TypeScript 完全重构，在此向 uView UI 原作者及所有贡献者致以诚挚感谢。

同时感谢每一位为 uView Pro 提交 Issue、PR 和改进建议的社区开发者。