介绍 ​

@silver-formily/react 来自对官方 @formily/react 的迁移与重构，是 Silver Formily 体系在 React 侧的表单渲染层：字段组件、Schema 渲染、connect 接入工具都由本包提供，表单模型、校验与响应式能力则分别来自 @silver-formily/core、@silver-formily/validator 与 @silver-formily/reactive。

本指南默认使用 @silver-formily/* 命名空间。如果你还在维护 @formily/* 的旧工程，请将这些包名视为迁移前的历史背景，而不是当前推荐写法。

安装 ​

pnpm add @silver-formily/react @silver-formily/core react@19 react-dom@19

npm install @silver-formily/react @silver-formily/core react@19 react-dom@19

快速上手 ​

import { createForm } from '@silver-formily/core'
import { Field, FormProvider } from '@silver-formily/react'
import { useState } from 'react'

export default function App() {
  const [form] = useState(() => createForm())
  return (
    <FormProvider form={form}>
      <Field name="input" component={[Input]} />
    </FormProvider>
  )
}

function Input(props: { value?: string, onChange?: (value: string) => void }) {
  return (
    <input
      value={props.value ?? ''}
      onChange={(event) => {
        props.onChange?.(event.target.value)
      }}
    />
  )
}

只要组件消费 value / onChange 这对受控属性，就可以直接作为 component 传入 Field，无需额外封装。

重大改动 ​

• @silver-formily/react 仅兼容 react / react-dom ^18 || ^19，且只发布 ESM 产物。
• 底层响应式依赖切换为 @silver-formily/reactive + @silver-formily/reactive-react，observer 从 @silver-formily/reactive-react re-export，API 以本仓库 reactive-react 文档为准。
• createSchemaField 现在只返回一个 SchemaField 组件，Markup 子组件以静态属性的形式挂载：SchemaField.Markup、SchemaField.String、SchemaField.Object 等。
• 字段挂载与副作用订阅（useFormEffects 等）基于 useCompatEffect / useCompatFactory 实现，同步 StrictMode effect 重放会保留已挂载资源；真正卸载的清理延迟到微任务，未提交渲染的资源由垃圾回收机制处理。
• @silver-formily/react 不导出 Schema。Schema、ISchema 请从 @silver-formily/json-schema 导入；x-reactions、x-component-props 是 Schema 属性，不是命名导出，完整文档查看 JSON Schema 文档。

FormProvider 挂载期间保持 form 稳定；替换整个 form 时应通过 key={form.id} 等方式重新挂载 Provider 与子树。包支持 React 18/19，react-dom 应使用对应版本。TypeScript 使用者还需安装 React 类型包，公开 NoInfer 类型要求 TypeScript 5.4+。package.json 中的内部 @silver-formily/* 依赖以 peer 声明，包管理器不自动安装 peer 时需显式安装。