@geajs/vite-plugin

中文文档
1.5.0发布于 2026/09/30MITTypeScriptES Module近 30 天下载 3967

Gea 框架的 Vite 插件 - JSX/TSX 变换,反应, HMR

中文使用文档
文档目录13 节
  1. 安装
  2. 配置
  3. 它会做什么
  4. HTML 字符串汇编中的 JSX
  5. 反应绑定生成
  6. 活动代表团
  7. 函数转换为类
  8. 条件和列表
  9. 热模块替换
  10. 类型脚本设置
  11. 虚拟模块
  12. 相关软件包
  13. 许可证

@geajs/vite-plugin (英语)

npm version License: MIT

授权的 Vite 插件 盖亚编译时间 JSX 转换,反应式绑定生成,事件授权接线,热模块替换.

安装

npm install -D @geajs/vite-plugin

要求数 vite ^7.3.1 作为同伴依赖.

配置

// vite.config.ts
import { defineConfig } from 'vite'
import { geaPlugin } from '@geajs/vite-plugin'

export default defineConfig({
  plugins: [geaPlugin()]
})

就是这样。 不需要配置选项——插件自动处理一切.

它会做什么

HTML 字符串汇编中的 JSX

插件将 JSX 在您的 .jsx 财务报告和审定财务报表 .tsx 文件在构建时输入 HTML 模板字符串。 这意味着没有 createElement 调用运行时的调用——模板编译到插入 DOM 的平面字符串.

  • className 自动转换为 class
  • 反应式事件名称被转换为Gea的小写属性(onClick 变成 click(中文(简体) )
  • 组件标记转换为 kebab 大小写自定义元素 data-prop-* 属性

反应绑定生成

插件分析您模板读取的状态路径( 例如, ), counterStore.count生成 observe() 要求只更新依赖于改变状态的 DOM 节点。 不需要虚拟 DOM 传输 .

活动代表团

在JSX中宣布的事件处理者(click={fn}, (中文(简体) ), input={fn}编译为 events 使用事件代表团的获取器——每个事件类型一个单一的全球听众 document.body,而不是每个元素的单个听众.

函数转换为类

函数组件在构建时会自动转换为类组件. 您写入简单函数; 插件处理其它函数 :

// What you write
export default function Greeting({ name }) {
  return <h1>Hello, {name}!</h1>
}

// What the plugin produces (conceptually)
class Greeting extends Component {
  template({ name }) {
    return `<h1>Hello, ${name}!</h1>`
  }
}

条件和列表

  • 有条件的表达式cond && <X />)汇编成 <template> 有高效互换逻辑的标记
  • .map() 电话 key 道具编译为 applyListChanges 手柄添加、删除、重排和互换而不触碰未更改项目的电话

热模块替换

插件注入 HMR 支持,通过编辑保存组件状态. 当您保存一个文件时,只更新已更改的组件——没有整页重装.

类型脚本设置

Gea 通过 TypeScript 提供 JSX 类型检查 jsxImportSource当您 tsconfig.json 包含 "jsx": "react-jsx" 财务报告和审定财务报表 "jsxImportSource": "@geajs/core",编辑器会获得完整的道具自动补全,在无效属性上打出错误,并会徘徊类型——没有任何框架特定的插件. 插件还添加 gea-env.d.ts 页:1 compilerOptions.types 用于额外类型支持的阵列.

虚拟模块

插件提供了一个 virtual:gea-reconcile 用于按键列表调节的内部模块.

许可证

麻省理工学院 ——版权(c) 2017年至今 阿玛干·安卡拉尔

版本与发布记录

@geajs/vite-plugin 共发布 41 个版本,首次发布于 2026/03/18;过去 12 个月发布了 41 个版本。

版本发布日期距今
1.5.0latest2026/09/301 个月前
1.4.32026/09/241 个月前
1.4.22026/09/231 个月前
1.4.12026/06/294 个月前
1.4.02026/06/284 个月前
1.3.12026/04/276 个月前

关于 @geajs/vite-plugin 的常见问题

@geajs/vite-plugin 是什么?

Gea 框架的 Vite 插件 - JSX/TSX 变换,反应, HMR

如何安装 @geajs/vite-plugin?

在项目目录运行 npm install @geajs/vite-plugin,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:vite(^8.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@geajs/vite-plugin 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@geajs/vite-plugin 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@geajs/vite-plugin 可以商用吗?

@geajs/vite-plugin 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@geajs/vite-plugin 的下载量有多少?

根据 npm 官方下载统计,@geajs/vite-plugin 在 2026/10/16 – 2026/11/14 这 30 天内被下载 3,967 次,日均约 132 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@geajs/vite-plugin 还在维护吗?

最新版本 1.5.0 发布于 2026/09/30(1 个月前);至今共发布 41 个版本,其中过去 12 个月发布了 41 个;首次发布于 2026/03/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。