# @geajs/vite-plugin 中文文档

规范地址：https://npmcn.com/package/%40geajs/vite-plugin/

版本：1\.5\.0
npm 元数据更新时间：2026-09-30T00:36:05.012Z
中文译文更新时间：2026-11-16T01:24:14.414Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40geajs/vite-plugin
原文对照：https://npmcn.com/package/%40geajs/vite-plugin/?lang=original
项目主页：https://github.com/dashersw/gea#readme
源码仓库：https://github.com/dashersw/gea

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：419 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：6 个
- peer 依赖：vite ^8\.0\.0
- 首次发布：2026-03-18T12:05:23.588Z
- 最新版本发布：2026-09-30T00:36:04.837Z
- 近 30 天下载量：3967（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：41（近 12 个月 41 个）

## 中文简介

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

## 安装

```sh
npm install @geajs/vite-plugin
```

也可以使用：`pnpm add @geajs/vite-plugin`、`yarn add @geajs/vite-plugin`、`bun add @geajs/vite-plugin`

## README

# @geajs/vite-plugin (英语)

[![npm version](https://badge.fury.io/js/%40geajs%2Fvite-plugin.svg)](https://www.npmjs.com/package/@geajs/vite-plugin) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/dashersw/gea/blob/master/LICENSE)

授权的 Vite 插件 [盖亚](https://www.npmjs.com/package/@geajs/core)编译时间 JSX 转换,反应式绑定生成,事件授权接线,热模块替换.

## 安装

```bash
npm install -D @geajs/vite-plugin
```

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

## 配置

```ts
// 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`,而不是每个元素的单个听众.

### 函数转换为类

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

```jsx
// 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` 用于按键列表调节的内部模块.

## 相关软件包

-   **[@ geajs/ 分数](https://www.npmjs.com/package/@geajs/core)** - 核心框架
-   **[@geajs/移动](https://www.npmjs.com/package/@geajs/mobile)** ——移动UI原始人
-   **[创建- gea](https://www.npmjs.com/package/create-gea)** 项目脚手架

## 许可证

[麻省理工学院](https://npmcn.com/package/%40geajs/vite-plugin/LICENSE) ——版权(c) 2017年至今 阿玛干·安卡拉尔

## 常见问题

### @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 和提交记录判断。

