Library Oruga 无样式依赖的轻量Vue组件库

很多 Vue 组件库要么绑定一套你未必喜欢的设计系统，要么体积庞大、难以改风格。想要“只给组件逻辑与结构、样式我自己来”的方案，选择有限。
Oruga 的切入点，是做一个无 CSS 框架依赖的轻量 Vue 组件库：它提供组件的行为与标记，样式交给你（或官方可选主题），从而与任意设计系统共存。

项目基本信息

一、项目介绍

oruga-ui/oruga 是一个轻量的 Vue.js UI 组件库，MIT 协议，核心不依赖任何 CSS 框架。你可以用 createOruga 注册组件，再自带样式或用官方提供的主题（themes）。组件按功能导入、可树摇，适合想保留设计主权、又不想从零写组件逻辑的 Vue 团队。

二、核心优势

1. 无样式依赖：只给逻辑与结构，样式完全自定义。
2. 轻量可摇树：按需引入，未用的组件不进包。
3. 主题可选：可自带样式或使用官方主题。
4. Vue 3 友好：面向现代 Vue 生态。
5. 可控性强：与既有设计系统无缝共存。

三、适用场景

• Vue 团队想自建设计系统。
• 需要可定制、无强约束的组件底座。
• 已有主题体系、只缺组件逻辑。
• 对包体积与可摇树有要求。

四、安装教程

安装 Vue 3 版本：

npm install @oruga-ui/oruga-next

常见报错：Vue 2 项目需使用旧版 oruga 包（非 -next）；未引入任何样式时组件无外观，需自备 CSS 或装主题。

五、使用示例

注册并使用组件：

import { createApp } from 'vue'
import { createOruga } from '@oruga-ui/oruga-next'

const oruga = createOruga()
createApp(...).use(oruga, { /* 配置 */ })

也可局部导入单组件（如 Autocomplete、Sidebar）后在模板使用。真实效果：组件具备交互逻辑（如自动完成、侧栏开关），外观由你的样式决定。

六、常见问题

Q：必须用某个 CSS 框架吗？
A：不必，Oruga 无样式依赖；你也可选用官方主题。
Q：支持 Vue 2 吗？
A：新版 oruga-next 面向 Vue 3，Vue 2 请用对应旧版。
Q：和 Element Plus 区别？
A：Element Plus 自带完整设计系统，Oruga 更偏无样式、可定制底座。

七、总结

Oruga 把 Vue 组件库拆成“逻辑 + 可选样式”两层，给想要设计主权的团队一个轻量、可摇树、无强约束的底座。对已有主题体系、只缺组件行为的 Vue 项目尤其合适；MIT 协议、Vue 3 友好。