🧭 决策指南
为什么现在热: 材料显示 [email protected] 已发布,仓库当日新增 40 星并进入 GitHub Trending;README 同时突出 Solid 2.0、Streaming SSR、progressive hydration 和面向 AI 助手的 SKILL.md/CHEATSHEET.md,但无法仅凭材料确定具体受关注原因。
适合,如果你
-
你在 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 是否适合作为运行时框架?
不适合,因为 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"
不适合
我现在维护 Solid 1.x 应用,目标版本是 [email protected],而且会使用 AI 生成组件代码;我能否只升级 npm 依赖而不逐项检查 API?
不适合只升级依赖,因为 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
适合
我需要在 Node LTS、Deno 或 Cloudflare Workers 上做 SSR,并逐步引入流式 SSR 和渐进式水合;Solid 是否满足这个部署约束?
适合,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
适合
我们正在用 TypeScript、JSX 和 Vite 构建高交互 Web 应用,列表和状态会频繁变化;Solid 2.0 是否适合替代依赖 Virtual DOM 的方案?
适合,因为 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
适合
我们使用 TypeScript 和现代浏览器,需要把 Promise、AsyncIterable、加载状态和乐观更新纳入 UI 状态;Solid 2.0 能否覆盖这些需求?
适合,因为 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
适合
我们希望复用 TypeScript、JSX 和响应式逻辑到非 DOM 平台,而不是只渲染浏览器页面;Solid 的架构是否支持自定义渲染器?
适合,但前提是你们愿意实现并维护目标平台的渲染器,因为 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
✨ 核心亮点
-
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 集成的开发者