Solid:用细粒度响应式直接更新真实 DOM 的 TypeScript UI 库
Solid 是给 TypeScript/JSX 团队的 UI 库,直接按依赖更新真实 DOM,不做 Virtual DOM diff。
GitHub solidjs/solid 更新 2026-11-19 分支 main 星标 36.6K 分叉 1.2K
TypeScript JavaScript JSX 细粒度响应式 真实 DOM Vite SSR Web Components

🧭 决策指南

适合,如果你

  • 你在 Vite 项目中使用 TypeScript、JSX,并希望组件函数只运行一次。
    README 的“Quick start”和“At a glance”示例使用 Vite、TypeScript、JSX,并明确组件函数 runs once。
  • 你的应用需要 Streaming SSR、progressive hydration 或 @solidjs/web 的 hydrate。
    README 的“Key features”和 Repository 表格列出 Streaming SSR、progressive hydration 与 @solidjs/web 的 hydrate。
  • 你希望用 createSignal、createMemo、createStore 实现细粒度状态更新。
    README 的“Key features”列出这些 reactive primitives,并说明更新只触及依赖状态的代码。
  • 你需要非 DOM 平台渲染器或 Web Components 支持。
    README 的“Key features”和 Repository 表格列出 @solidjs/universal 与 @solidjs/element。

不适合,如果你

  • 你的目标浏览器包含 IE 或其他 sunset 浏览器。
    README 的“Browser support”明确写明 IE and similar sunset browsers are not supported。
  • 你的代码依赖 Solid 1.x 示例,却不准备阅读 Solid 2.0 migration guide。
    README 的“Coming from Solid 1.x?”和“For LLMs / AI assistants”都说明 2.0 API 与旧示例不同,并提供迁移文档。
  • 你的同步互操作逻辑不能接受默认延迟到下一个 microtask 的更新。
    README 的“Explain this!”写明 reads update on the next microtask,需要同步互操作时调用 flush()。
  • 你的项目不使用 JSX、TypeScript 或 README 列出的 Solid 编译器链路。
    README 的“Key features”称其为 TypeScript-first、JSX-first;Quick start 使用 @solidjs/vite-plugin。

前置条件

  • Node LTS、最新 Deno 或 Cloudflare Worker runtimes;依据 README 的“Browser support”。
  • 现代 Firefox、Safari、Chrome、Edge 的最近 2 年版本;依据 README 的“Browser support”。
  • Vite 项目可安装 solid-js、@solidjs/web、@solidjs/vite-plugin;依据 README 的“Quick start”。
  • Solid 2.0 项目应阅读 packages/solid/skills/solid-2.0/SKILL.md、packages/solid/CHEATSHEET.md 和 documentation/solid-2.0/MIGRATION.md;依据 README 的“For LLMs / AI assistants”。

第一步命令(README 原文)

npx degit solidjs/templates/solid-v2/basic my-app

要注意

  • 不要把 Solid 1.x 示例直接当作 2.0 API 使用。
    README“For LLMs / AI assistants”明确要求先阅读 SKILL.md、CHEATSHEET.md 和 MIGRATION.md。
  • 依赖变更默认在下一个 microtask 生效,要求同步时必须关注 flush()。
    README“Explain this!”明确写出 next microtask 和 flush() for synchronous interop。
  • JSX 类型配置需要指向 @solidjs/web,而不是只安装 solid-js。
    README“Quick start”要求 jsx 为 preserve、jsxImportSource 为 @solidjs/web。
  • solid-js、@solidjs/web 等运行时共享版本,但 @solidjs/h、@solidjs/html、@solidjs/element 可独立发版。
    README“Repository”对 PNPM workspaces monorepo 的版本规则有明确说明。

替代方案

  • Solid 1.x:已有 Solid 1.x 代码或示例,需要沿用 1.x API 时更合适。
    README“Coming from Solid 1.x?”
  • @solidjs/html:需要 build-less tagged template literals,而不是 JSX 编译链时更合适。
    README“Repository”
  • @solidjs/universal:需要把 Solid 运行时接到非 DOM 平台或自定义 renderer 时更合适。
    README“Key features”和“Repository”

材料未说明

  • 材料没有提供 Solid 2.0.1 的完整 breaking changes 清单。
  • 材料没有提供 JS Framework Benchmark 的具体分数或与其他框架的对比数字。
  • 材料没有说明生产构建、SSR 或 progressive hydration 的具体资源开销。
  • 材料没有说明官方维护团队规模;基础数据只提供 10 位贡献者。
  • 材料没有提供 5 个版本的具体发布日期、变更内容或升级策略。
  • 材料没有说明生态中具体 component library 的版本兼容范围。

💡 深度解析

6
不适合 我们的 Web 应用必须支持 IE 或类似旧浏览器,但新代码希望使用 JSX 和 TypeScript;Solid 是否适合作为运行时框架?
适合读者: 必须兼容 IE 或类似已停止支持的旧浏览器,同时希望采用 JSX 和 TypeScript 的 Web 应用维护者

不适合,因为 README 明确规定 SolidJS Core 只支持最近两年的现代 Firefox、Safari、Chrome 和 Edge,不支持 IE 及类似 sunset 浏览器。

  • Browser support 章节直接写明“IE and similar sunset browsers are not supported”,这与必须兼容旧浏览器的约束冲突。
  • README 的 Web 方案依赖 JSX 编译、真实 DOM 操作和现代响应式运行时;即使构建链能够转译语法,也不能据此推断运行时兼容 IE。
  • README 虽然支持桌面和移动端的现代 Firefox、Safari、Chrome、Edge,但没有承诺更老版本或 IE polyfill 方案。

因此,JSX 和 TypeScript 本身不是决定因素,真正阻断选型的是官方运行时浏览器支持范围。

  • README Browser support:"SolidJS Core supports the last 2 years of modern Firefox, Safari, Chrome, and Edge"
  • README Browser support:"IE and similar sunset browsers are not supported."
  • README Why Solid? / Pragmatic:"Built on JSX and TypeScript"
材料未说明:README 没有说明通过自定义 polyfill、旧版构建产物或第三方兼容层能否扩大浏览器范围。;README 没有提供 IE 下的运行时测试结果。
不适合 我现在维护 Solid 1.x 应用,目标版本是 [email protected],而且会使用 AI 生成组件代码;我能否只升级 npm 依赖而不逐项检查 API?
适合读者: 维护 Solid 1.x 应用、准备升级到 [email protected],并依赖 AI 或旧示例生成代码的前端工程师

不适合只升级依赖,因为 README 明确警告 Solid 2.0 的公开 API 与 2.0 之前的示例不同,且 1.x 与 2.0 并非无缝兼容。

  • README 要求迁移者阅读 documentation/solid-2.0/MIGRATION.md,说明升级包含 API 和行为层面的核对。
  • AI 生成代码前必须阅读 SKILL.md、CHEATSHEET.md 和迁移指南;项目特别指出旧示例可能导致错误的 2.0 代码。
  • 1.x 仍在 1.x 分支维护,并可通过 npm i solid-js@v1-latest 安装,说明新旧版本可以并行参考,但不能混用心智模型。
  • 发行数据显示最新版本为 [email protected],当前升级目标应锁定与编译器、渲染包兼容的版本组合。

直接复制旧版 Effect、异步或控制流写法,可能得到行为不符合预期的代码。

  • README For LLMs / AI assistants:"The public API differs from any Solid examples that predate 2.0."
  • README For LLMs / AI assistants:"Before generating Solid 2.0 code, read... SKILL.md... CHEATSHEET.md... MIGRATION.md"
  • README Coming from Solid 1.x?:"Solid 1.x is maintained on the `1.x` branch"
  • 项目核心数据:latest_release 为 `[email protected]`
npm i solid-js @solidjs/web
材料未说明:README 没有列出你的 1.x 应用实际使用了哪些已变更 API。;README 没有提供从 1.x 升级到 2.0.1 的自动迁移工具或具体工时。
适合 我需要在 Node LTS、Deno 或 Cloudflare Workers 上做 SSR,并逐步引入流式 SSR 和渐进式水合;Solid 是否满足这个部署约束?
适合读者: 需要 Node LTS、Deno 或 Cloudflare Workers 服务端渲染,并计划使用流式 SSR 和渐进式水合的全栈工程师

适合,README 直接列出这些服务端运行环境,并把 SSR、流式输出和渐进式水合作为一等 Web 能力。

  • Browser support 章节明确支持 Node LTS、最新 Deno 和 Cloudflare Worker runtimes。
  • Key features 列出“Streaming SSR and progressive hydration”,说明不只支持传统一次性服务端渲染。
  • README 的 Powerful 章节还提到完整 SSR、streaming,以及在准备好后再迁移到服务端的能力。
  • @solidjs/web 负责浏览器 DOM、SSR、hydrate 等平台能力,而 solid-js 保持渲染器无关,有利于服务端与客户端使用统一组件模型。

但这不是零配置部署:服务端数据边界、客户端水合一致性和异步时序仍需按目标运行时处理。

  • README Browser support:"For server environments, Node LTS, the latest Deno, and Cloudflare Worker runtimes are supported."
  • README Key features:"Streaming SSR and progressive hydration."
  • README Why Solid? / Powerful:"Full SSR, streaming, and progressive hydration"
  • README Quick start:"`solid-js` owns renderer-neutral component types, while renderer packages such as `@solidjs/web`..."
npm i solid-js @solidjs/web
材料未说明:README 没有说明目标框架、路由器或数据获取层在 Cloudflare Workers 与 Deno 上的具体适配方式。;README 没有给出流式 SSR 的完整部署配置、缓存策略或水合失败处理方案。
适合 我们正在用 TypeScript、JSX 和 Vite 构建高交互 Web 应用,列表和状态会频繁变化;Solid 2.0 是否适合替代依赖 Virtual DOM 的方案?
适合读者: 正在构建高频状态变化、复杂列表和大规模交互 Web 应用,并使用 TypeScript、JSX 与 Vite 的前端团队

适合,因为 Solid 2.0 将 JSX 编译为真实 DOM 操作,并按表达式而不是组件或整棵树更新。

  • README 明确说明“不使用 Virtual DOM”,状态变化时只有依赖该状态的代码重新运行。
  • 组件函数在挂载时执行一次,{doubled()} 这类表达式才会被追踪更新,适合高频局部变化。
  • createSignal、createMemo、createStore 提供内置细粒度响应式状态管理,不必额外引入完整状态层。
  • README 还列出树摇、较低运行时开销,并称运行时成本接近优化后的原生 JavaScript。

不过,收益取决于状态读取是否足够细粒度;过宽的 Store 或不必要的 Effect 可能削弱这种优势。

  • README:"Instead of a Virtual DOM, it compiles templates to real DOM nodes and updates them with fine-grained reactivity."
  • README:"The component body runs once. Only `{doubled()}` updates when count changes."
  • README Key features:"Fine-grained updates to the real DOM"、"Declarative reactive primitives"
  • README Why Solid? / Performant:"runtime cost is close to optimized vanilla JavaScript"
npx degit solidjs/templates/solid-v2/basic my-app
材料未说明:README 没有给出你的实际列表规模、交互频率或与现有框架的基准测试结果。;README 没有说明现有业务代码迁移到细粒度状态模型所需的重构量。
适合 我们使用 TypeScript 和现代浏览器,需要把 Promise、AsyncIterable、加载状态和乐观更新纳入 UI 状态;Solid 2.0 能否覆盖这些需求?
适合读者: 在现代浏览器上使用 Solid、需要处理异步数据和乐观更新,并计划用响应式原语替代部分外部状态管理的 TypeScript 团队

适合,因为 Solid 2.0 把异步计算和乐观更新直接放进响应式模型,而不是只提供同步 UI 状态。

  • Key features 明确支持 Promise、AsyncIterable、异步边界和 isPending,可把异步结果与 UI 响应式计算连接起来。
  • README 同时列出 createOptimistic、createOptimisticStore 和结构化 action(...) mutations,覆盖乐观界面与异步变更。
  • createSignal、createMemo、createStore 是内置原语,适合在 TypeScript、JSX 组件中表达状态、派生值和对象状态。
  • 现代浏览器支持范围是最近两年的 Firefox、Safari、Chrome 和 Edge,与你们的部署前提一致。

但 README 没有证明它能替代某个特定数据层或请求库,外部缓存、重试和持久化策略仍需另行确认。

  • README Key features:"First-class async: any computation can return a `Promise`/`AsyncIterable`"
  • README Key features:"Optimistic UI primitives (`createOptimistic`, `createOptimisticStore`) and structured `action(...)` mutations."
  • README Key features:"Declarative reactive primitives (`createSignal`, `createMemo`, `createStore`)."
  • README Browser support:"last 2 years of modern Firefox, Safari, Chrome, and Edge"
npm i solid-js @solidjs/web
材料未说明:README 没有说明与具体请求库、缓存库或路由器的集成方式。;README 没有给出异步错误处理、取消请求和持久化状态的完整 API 方案。
适合 我们希望复用 TypeScript、JSX 和响应式逻辑到非 DOM 平台,而不是只渲染浏览器页面;Solid 的架构是否支持自定义渲染器?
适合读者: 希望把同一套 TypeScript、JSX 和响应式逻辑部署到非 DOM 目标,并愿意编写自定义渲染器的工程团队

适合,但前提是你们愿意实现并维护目标平台的渲染器,因为 Solid 将核心响应式能力与具体平台渲染拆开。

  • README 说明 solid-js 拥有 renderer-neutral component types,不把核心组件模型绑定到浏览器 DOM。
  • @solidjs/universal 明确用于编写 custom renderers,以 targeting non-DOM platforms。
  • @solidjs/web、@solidjs/h 等渲染包各自拥有 JSX namespace 和 jsx-runtime 类型入口,说明平台适配位于渲染包而非核心响应式模型。
  • 项目洞察还指出,编译器、响应式运行时和平台渲染包协作,支持 Web Components、自定义渲染器和非 DOM 目标。

因此它适合有平台适配能力的团队,不等于已经提供所有非 DOM 平台的现成组件库。

  • README Key features:"Universal: write custom renderers via [`@solidjs/universal`] to target non-DOM platforms."
  • README Quick start:"`solid-js` owns renderer-neutral component types"
  • README Quick start:"renderer packages such as `@solidjs/web` and `@solidjs/h` own their JSX namespaces"
  • 项目洞察 solution_analysis:"核心运行时与平台渲染解耦"
npm i solid-js @solidjs/web
材料未说明:README 没有说明目标非 DOM 平台的节点、事件和生命周期接口。;README 没有提供自定义渲染器的完整示例、维护成本或目标平台组件生态。

✨ 核心亮点

  • createSignal 只更新发生变化的 DOM 表达式
  • 组件函数挂载时运行一次,不做 Virtual DOM diff
  • 支持 Promise、AsyncIterable 与流式 SSR
  • [email protected] 提供 TypeScript-first JSX 体验
  • Solid 2.0 API 与旧版示例存在差异

🔧 工程化

  • solid-js 提供 createSignal、createMemo 和 createStore 响应式原语
  • @solidjs/web 负责 render、hydrate、SSR、Portal 和 dynamic
  • Promise、AsyncIterable 可作为异步计算,配合 Suspense 边界
  • Streaming SSR 与 progressive hydration 支持渐进式服务端渲染

⚠️ 风险

  • Solid 2.0 公共 API 不兼容部分 1.x 示例和写法
  • 更新默认批处理到下一个 microtask,需用 flush() 做同步互操作
  • IE 等 sunset 浏览器不在 SolidJS Core 支持范围内
  • PNPM workspaces monorepo 中运行时与编译器版本规则不同

👥 适合谁?

  • 使用 TypeScript、JSX 和 Vite 构建现代 Web UI 的团队
  • 需要 SSR、流式输出或 progressive hydration 的应用
  • 需要自定义渲染器或 Web Components 集成的开发者