# @getforma/core 中文文档

规范地址：https://npmcn.com/package/%40getforma/core/

版本：3\.2\.0
npm 元数据更新时间：2026-10-27T18:13:04.917Z
中文译文更新时间：2026-11-16T06:07:12.968Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40getforma/core
原文对照：https://npmcn.com/package/%40getforma/core/?lang=original
项目主页：https://getforma.dev/
源码仓库：https://github.com/getforma-dev/forma

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

- 包体积（解压后）：8.8 MB，112 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：1 个
- 首次发布：2026-03-13T19:15:38.930Z
- 最新版本发布：2026-10-27T18:13:04.477Z
- 近 30 天下载量：10099（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：45（近 12 个月 45 个）

## 中文简介

真正的 DOM 反应库——细纹信号,岛屿建筑,SSR水分. 没有虚拟的DOM,没有抖动。 CDN HTML 运行时使用一个零 eval 的 CSP 安全允许列表表达式解释器. 套装大小由脚本/检查大小-mjs来测量.

## 安装

```sh
npm install @getforma/core
```

也可以使用：`pnpm add @getforma/core`、`yarn add @getforma/core`、`bun add @getforma/core`

## README

# 福马JS

[![CI](https://github.com/getforma-dev/forma/actions/workflows/ci.yml/badge.svg)](https://github.com/getforma-dev/forma/actions/workflows/ci.yml) [![npm](https://img.shields.io/npm/v/@getforma/core)](https://www.npmjs.com/package/@getforma/core) [![Socket Badge](https://socket.dev/api/badge/npm/package/@getforma/core)](https://socket.dev/npm/package/@getforma/core) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

反应 DOM 库有精细的纹理信号. 没有虚拟 DOM —— 信号只更新改变的 DOM 节点. 组件运行一次.

> **此所坐之处.** 1个产品,1个寄存器,8个源包(包括可选路由器):
> 
> ```
> TS/JSX → @getforma/compiler → FMIR (binary) → forma-ir walker → HTML → @getforma/core adopts it
>          packages/compiler                    crates/forma-ir          packages/core
> ```
> 
> **你在这里:** 客户端运行时间——信号, `h()`,岛屿,水合,和零建 HTML运行时间。 它完全靠自己运作;其余的堆栈是选入. 新来的? 读取 **[3.0 架构](https://github.com/getforma-dev/forma/blob/main/docs/ARCHITECTURE-3.0.md)** 先说 这个 [Forma 工作空间](https://github.com/getforma-dev/forma) 还装有编译器、建造管线、碎屑箱和脚手架.

```tsx
import { createSignal, h, mount } from "@getforma/core";

const [count, setCount] = createSignal(0);

function Counter() {
  return (
    <button onClick={() => setCount((c) => c + 1)}>
      {() => `Clicked ${count()} times`}
    </button>
  );
}

mount(() => <Counter />, "#app");
```

无复出使. 无依赖数组 。 没有 `useMemo`按钮文本更新,因为它读取 `count()` 在反应函数内——树上没有其它东西被触动.

* * *

## 安装

安装协调的3.2.0核心 :

```bash
npm install @getforma/core@3.2.0
```

添加可选 [路由器](https://npmcn.com/package/%40getforma/router/README.md) 用于客户端导航。 这个 [路由指南](https://npmcn.com/package/docs/ROUTING.md) 解释浏览器渲染、岛屿和 本地导航; 只使用核心的应用程序不需要路由器.

对于单独的平稳 2.1.0 运行时间,以下URL仅保留为 历史实例。 他们用的是旧的自动生命周期 而不是明确的 3.0 挂载合同如下。 对于目前的不建用途,请填写 `dist/formajs-runtime.global.js` 您已安装的合格软件包中的文物 :

```html
<!-- jsDelivr (recommended) -->
<script src="https://cdn.jsdelivr.net/npm/@getforma/core@2.1.0/dist/formajs-runtime.global.js"></script>

<!-- unpkg -->
<script src="https://unpkg.com/@getforma/core@2.1.0/dist/formajs-runtime.global.js"></script>
```

> **生产:** 将限定的版本而不是移动的 Dist- tag .

任何捆绑工的作品——Vite,esbuild,tsup,webpack,Rollup. FormaJS船舶标准无害环境管理和CJS通过 `package.json` 出口。 没有插件, 没有特殊配置 。 关于JSX,设定 `jsx: "react"`, (中文(简体) ), `jsxFactory: "h"`, (中文(简体) ), `jsxFragmentFactory: "Fragment"`。 。 。 .

按 `npm run check:size` fORMA-294 核心候选人名单 `1d204ba4` 在2026-10-25上(随后的选入决定更改了无核心运行时间字节). 脚本将真实的无害环境管理导入图走过,重磅共享块,如果任何条目超过其限制,则失败:

| 艺术 | 击出 | CI 限制 |
| --- | --- | --- |
| `@getforma/core` 输入 + 每一块 | 48.6 基贝(49 796 B) | 49 926 B (单位:千美元) |
| CDN HTML 运行时间 (`formajs-runtime.global.js`(中文(简体) ) | 40.1 基贝(41,113 B) | 41 500个B级 |
| CDN HTML 运行时间, 硬化(`formajs-runtime-hardened.global.js`(中文(简体) ) | 39.4 基贝(40 384 B) | 40 500个B级 |
| CDN 浏览器 ESM (`forma.esm.js`,内含外星信号) | 47.6 基贝(48 776 B) | 49,136 B (单位:千美元) |
| 预览帧运行时间( E)`formajs-frame.global.js`,由服务器内置) | 38.9 基贝(39 867 B) | 4万个B |

核心数字是: **无花草** - 这是一切 `dist/index.js` 停车 卸下你应用的进口船数量. `@getforma/build` 仍然拒绝Forma代码28,420 B gzip -9以上的路线. 这个 [3.1 业绩决定](https://npmcn.com/package/docs/release/3.1-PERFORMANCE-TRADEOFFS.md) 记录较早的效应交付费用。 分开 [FORMA-294号决定](https://npmcn.com/package/docs/release/FORMA-294-COMPILER-CANDIDATE.md) 接受584 B的货包生长,只将货包上限从49,414 B提高到49,926 B. 可选帮助者本身被排除在主干之外;分割其共享的依赖性产生大部分的运输增加. 模板编译默认关闭,仍受每个路由预算的约束. 原始的失败测量仍然失败; 包封顶与路由预算分开 .

为了进行历史比较,3.0.0-dev建筑 `91a50157` 在2026-10-16测得48,602 B核,39,203 B运行时间,37,629 B硬化运行时间,48,836 B浏览器无害环境管理和38,687 B帧运行时间. 其计数器和指数化的SSSR航道测得福尔马码的26,213 B和28,071 B. 原28,100 B N2门和原50 ms N3 条件属于L-64决定;它们不会被3.1决定追溯更改. 核心和浏览器的无害环境管理数字从2.1.0的29,515 B和28,369 B增加到严格启动的岛屿(FORMA-104)和宣布的岛屿国家块(FORMA-103)。 所测量的大小可以改变;一个测试保持了当前表格的 CI 限制与门脚本一致.

经核实 `src/__tests__/docs-truth.test.ts` >"大小表引用 CI 门实际执行的限制"

* * *

## 三个用法

三个都共享相同的信号图和反应引擎. 选一个,或者混在一起.

|  | 看起来像什么 | 需求 |
| --- | --- | --- |
| **联合来文十** | `<button onClick={…}>{() => count()}</button>` | 装有JSX变换器的捆绑机 |
| **上标** | `h("button", { onClick: fn }, () => count())` | 捆绑器 |
| **HTML 运行时间** | `<button data-on:click="{count++}">` | 一个运行时脚本和一个明确的挂载调用 |

JSX汇编为 `h()` 相同功能,没有JSX特定的运行时间. HTML 运行时间绑定已审查的标记 `mountMarkup()` 给同样的信号。 装入脚本本身没有任何束缚.

```html
<script src="/vendor/formajs-runtime.global.js"></script>
<main id="counter">
  <div data-forma-state='{ "count": 0 }'>
    <p data-text="{count}"></p>
    <button data-on:click="{count++}">+1</button>
    <button data-on:click="{count = 0}">Reset</button>
  </div>
</main>
<script src="/counter.js"></script>
```

`counter.js` 明确启动已审查的计数器( 在您的 CSP 下保留此脚本) :

```js
const root = document.getElementById('counter');
const counter = FormaRuntime.mountMarkup(root, FormaRuntime.trustedHtml(root.innerHTML), { tier: 'reviewed' });
// counter.update(FormaRuntime.trustedHtml(nextMarkup)); counter.unmount();
```

除非有请求, 挂载不会允许获取、 外部 DOM 访问或导航 。 不需要建设步骤。 → [文件/HTML-RUNTIME.md](https://npmcn.com/package/%40getforma/core/docs/HTML-RUNTIME.md) 每个指令和表达语法.

经核实 `src/__tests__/readme-examples.test.ts` >"内幕计数器工作没有eval"

* * *

## 为什么福玛JS

**组件运行一次.** 没有虚拟 DOM 或组件树 diffing 。 密钥列表仍然对齐他们的行. `h('div')` 返回实际 `HTMLDivElement`。当一个信号改变时,只有读取它更新的具体文本节点或属性——而不是组件,而不是树.

**精细有反应.** 电源 [异形符号](https://github.com/johnsoncodehk/signals) 3.x. 信号图跟踪依赖性自动。 没有依赖数组, 没有 stale 关闭, 没有 `useCallback` 编号 : `useMemo` 仪式.

**3个出入口,1个引擎.** 对组件使用 JSX 或超标, 或明确挂载已审查的 HTML 标记 . 本地 SSR 还需要申报道具和编译器所认可的子集.

**岛屿高于最高人民会议.** 编译 `activateIslands()` 激活前验证每一个原始SSD区域:成功采用使得初始DOM写作为零,不匹配的拒绝不修复,而失败仍被隔离每个岛屿. 整个岛屿之间合作加载工作产量;等待 `activateIslands()` 用于完成所要求的负载。 递延触发因素(`visible`, (中文(简体) ), `idle`, (中文(简体) ), `interaction`装备后就绪;处置释放属于工作。 → [文件/印度地图](https://npmcn.com/package/%40getforma/core/docs/ISLANDS.md)

**CSP -安全.** HTML 运行时间用允许列表 AST 解释器来评价表达式. **无 `eval()`无 `new Function()`无 `with()` 每件运出的物品** ——没有选入倒计时错误地离开转接,因为倒计时被删除. 拒绝 `scripts/verify-dist.mjs`,将构建的文件作为最后一步 `npm run build`,由Playwright spec提供 旗舰固定在真正的CSP头下.

经核实 `src/__tests__/runtime-csp-default.test.ts` >"没有构建可以到达新的函数,有任意配置" 经核实 `src/__tests__/build-artifacts.test.ts` > “没有构建出新函数或带有( ) 瞄准镜包装器”

**福马JS不是:** 对路径、数据采集或国家管理有意见的框架。 这是一个反应DOM库。 你带来了建筑.

### 计量,未断言

`npm run bench` 运行热路套间 `bench/`数字——每个数字旁边都有跑到跑的噪音地层,因此以后的比较可以发现一个糟糕的下午的倒退——生活在其中 [文件/实绩](https://npmcn.com/package/%40getforma/core/docs/PERFORMANCE.md)。它们是历史快乐的数字,而不是当前浏览器的时间。 严格采用现在使用连接的、匹配的固定装置和不同的交易;没有要求与旧的采用基准进行新的衡量或比较.

-   **写作会改变无所事事.** 等值的写作从未达到效果,其成本级低于一个. 基准:长凳/反应. bench.ts > "写出一个CHANGING值,效果运行 (×500)"
-   **`batch()` 崩溃重复写到一冲 .** 写到100没有用 _不同_ 信号,这是正确的结果. 依据: 长凳/反应. bench.ts > "一通信号,100个写作,分批(×30)"
-   **一个按键列表更新, 不更改密钥, 没有命令占用调和器的快速路径**,并重排其中的一小部分. 基准为: single/list.bench.ts >"相同的密钥,相同的顺序——调和器快速路径"
-   **历史上采用的基准比公司社会责任控制便宜**中,减去 HTML 解析。 这对退休的行走者进行了衡量;它没有确定严格的交易的当前成本. 基准:长凳/水合物.bench.ts > "一千万行:分析+通过数据形式键"
-   **历史基准比 `eval` 路径它替换** - 它需要没有 `unsafe-eval` 在你的CSP中. 基准为: single/expression.bench.ts > "8个依赖数的表达式:写出-评价-文本 (×20)"

* * *

## 文档

| 文档 | 它的答案是什么 |
| --- | --- |
| [文件/API.md](https://npmcn.com/package/%40getforma/core/docs/API.md) | `h()`、信号、控制流量、储存、组件、合成、传送门——以及四个未卫生的逃生舱门 |
| [文件/HTML-RUNTIME.md](https://npmcn.com/package/%40getforma/core/docs/HTML-RUNTIME.md) | 每个 `data-*` 指令和CSP安全表达语法及其限制 |
| [文件/印度地图](https://npmcn.com/package/%40getforma/core/docs/ISLANDS.md) | 将服务器发送到 HTML 中, 生成来自服务器数据的信号, 按键列表采纳 |
| [文件/CDN-AND-出口](https://npmcn.com/package/%40getforma/core/docs/CDN-AND-EXPORTS.md) | 用于加载的 CDN 构建, 以及每个子路径导出包含的内容 |
| [文件/COMPARISONS.md](https://npmcn.com/package/%40getforma/core/docs/COMPARISONS.md) | 和Solid的区别 |
| [文件/服务.md](https://npmcn.com/package/%40getforma/core/docs/STABILITY.md) | 装运了试验相容性API并拆除了入境点 |
| [文件/实绩](https://npmcn.com/package/%40getforma/core/docs/PERFORMANCE.md) | 基准热道,有噪音地板 |
| [警卫](https://npmcn.com/package/%40getforma/core/SECURITY.md) • 妇女 [CSP.md (中文(简体) )](https://npmcn.com/package/%40getforma/core/CSP.md) | 威胁模式;在严格的内容-安全政策下运行 |
| [文档/README.md](https://npmcn.com/package/%40getforma/core/docs/README.md) | 完整的文件索引,包括设计记录 |

实例: [`examples/`](https://npmcn.com/package/%40getforma/core/examples) ——计数器,计数器jsx,csp,todo,数据表.

* * *

## 福玛堆栈的一部分

### 前端( TypeScript)

| 软件包 | 说明 |
| --- | --- |
| [@ getforma/ 核心](https://www.npmjs.com/package/@getforma/core) | **这个图书馆** - 反应DOM、信号、岛屿、安全部门改革水分 |
| [@ getforma/ 编译器](https://www.npmjs.com/package/@getforma/compiler) | FMIR 编译器和 重建 SSR 插件 |
| [@ getforma/ 构建](https://www.npmjs.com/package/@getforma/build) | 生产管道——建造捆绑、内容散开、压缩、明细表 |

### 后端( Rust)

| 软件包 | 说明 |
| --- | --- |
| [福玛尔](https://crates.io/crates/forma-ir) | FMIR 二进制格式 — 剖析器和本地 HTML 行走器 |
| [forma 服务器](https://crates.io/crates/forma-server) | Axum 中间软件 — SSR 页面渲染, 资产服务, CSP 头 |

### 完整框架

| 软件包 | 说明 |
| --- | --- |
| [@ getforma/ 创建- app](https://github.com/getforma-dev/forma/tree/main/packages/create-app) | `npx @getforma/create-app` – 脚手架 一个 Rust 服务器 + TypeScript 前端工程 |

* * *

## 许可证

麻省理工学院

## 常见问题

### @getforma/core 是什么？

真正的 DOM 反应库——细纹信号,岛屿建筑,SSR水分\. 没有虚拟的DOM,没有抖动。 CDN HTML 运行时使用一个零 eval 的 CSP 安全允许列表表达式解释器\. 套装大小由脚本/检查大小-mjs来测量\.

### 如何安装 @getforma/core？

在项目目录运行 npm install @getforma/core，或使用 pnpm add / yarn add / bun add。

### @getforma/core 支持 TypeScript 吗？

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

### @getforma/core 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @getforma/core 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @getforma/core 可以商用吗？

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

### @getforma/core 的下载量有多少？

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

### @getforma/core 还在维护吗？

最新版本 3\.2\.0 发布于 2026/10/28（19 天前）；至今共发布 45 个版本，其中过去 12 个月发布了 45 个；首次发布于 2026/03/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

