7.3 社区资源与学习路径：面向React开发者的路线图

7.3 社区资源与学习路径：面向 React 开发者的路线图

本节摘要：Solid 的社区规模小于 React，但资源密度不低——官方文档、交互式教程、活跃的讨论区构成主干。本节画出资源地图，指出面向 React 开发者的三段式学习路径与各自的高频误区，并把本册章节编入路线，让"读教程"与"查资料"两条线互相咬合。

学一个新框架的成本，一半在语法，一半在"不知道去哪找答案"。Solid 的答案集中度其实很高：官方文档是唯一权威源，交互式教程覆盖响应式核心，社区讨论区活跃度对得上它的用户规模。对 React 开发者真正的风险不是资源少，而是拿着 React 的搜索习惯找 Solid 的答案——搜出来的旧文章可能描述的是语义已经变化的 API。路线图的头号原则因此是：以官方文档为锚，社区文章为辅。

资源地图

表里"核心作者博客"一格值得多说一句：Solid 是设计动机异常透明的项目——响应式内核的每次取舍都有长文论证，这在主流框架里相当罕见。想在团队里当"讲得清道理"的那个人，这些文章比任何二手教程都值钱。

三段式学习路径

第一段，校准心智（一到两天）。目标是把"重渲染"这个词从肌肉记忆里摘掉。材料：本册第 1 章、第 3 章，配合 1.2 节的 console.log 实验亲手跑一遍。检验标准：能向同事解释"为什么 Solid 不需要 memo"。高频误区：用 React 直觉预判执行次数。

第二段，原语与控制流（一到两周）。目标是形成信号化的条件反射。材料：本册第 2 章、第 4 章，交互式教程同步过一遍。检验标准：拿到一个 React 组件，能立刻说出改写时要删什么（依赖数组、memo、key）、换什么（useState 换 signal、map 换 For）。高频误区：解构 props、表达式里写列表、机械翻译 useMemo。

第三段，工程化与全栈（两到四周，与实战并行）。目标是把工具链、路由、数据层、测试连成完整流水线。材料：本册第 5 到 9 章，SolidStart 起一个真实小项目。检验标准：独立交付一个含路由、数据请求、表单与部署的完整功能。高频误区：数据获取还挂在 Effect 里、渲染策略选型凭感觉。

第一段 校准心智      第二段 原语与控制流     第三段 工程化与全栈
+--------------+    +----------------+    +----------------+
| 第1章 第3章  |    | 第2章 第4章    |    | 第5-9章        |
| console.log  | -> | 交互式教程     | -> | SolidStart     |
| 实验         |    | 改写旧组件练习 |    | 真实小项目     |
+--------------+    +----------------+    +----------------+
   一到两天            一到两周              两到四周
​

高频误区清单：迁移前的团队宣讲材料

把前两段路径里的误区集中成一张检查卡，迁移启动会上过一遍，能省掉大量返工：

1. 解构 props——拿到快照，断开响应（本册 3.3 详述）。
2. 表达式里 map 列表——只执行一次，列表永不更新（4.3）。
3. 机械翻译 useMemo 与 useCallback——多数应直接删除（2.4）。
4. 依赖数组思维残留——Effect 依赖自动追踪，别再造数组（2.2）。
5. 数据获取放 Effect——用资源或路由数据函数，SSR 首屏才有数据（5.2、6.2）。
6. 搜旧教程照抄——API 语义随版本演化，以官方文档为锚（本节）。

💡 团队迁移的推进节奏建议"平行小项目先行"：选一个边缘但完整的功能用 Solid 实现，跑通工具链、测试与部署全流程，再评估向核心模块推进。直接在主干上混合两个框架是最贵的学习方式。

试点周计划：把路径变成排期

三段路径落到日历上，可以压成试点周。周一：全员过第 1 章与第 3 章，每人本地跑通 console.log 实验，晚上各自读完 7.1 并配好 Vite 加插件的最小工程。周二：过第 2 章，把团队 React 代码库里最常用的三个 Hook 改写成组合原语，交叉评审。周三：过第 4 章，把一个真实列表页按 4.3 的改写清单翻成 Solid 版，重点验证 For 的行为。周四：过第 5 章，把该页面的数据层换成资源加 store，接上 Suspense。周五：接 9 章给页面配测试与部署预览，开复盘会记录踩坑清单。

一周试点的产出物有三样：一个真实模块的 Solid 版、一份团队自己的坑清单（比本册任何清单都宝贵）、一份"要不要继续"的初步判断。注意试点周的隐性目标——让团队在低风险环境里暴露争论，争论越早，迁移越稳。

问题：React 组件能不能嵌进 Solid 里过渡？

技术上可以：社区有把 React 渲染器挂进 Solid 树的桥接方案，适合"非它不可"的重型组件过渡（复杂表格控件、日历）。代价要说清：两套运行时同页共存，包体积叠加，事件体系各自为政，调试要开两副眼镜。把它当脚手架而不是地基——桥接组件的清单要写明替换期限，否则过渡态会变成永久态。

本节要点回顾

• 官方文档是唯一锚点：社区文章的 API 语义可能过时，搜索习惯要换。
• 三段式路径：校准心智、原语控制流、工程化全栈，各有检验标准。
• 误区检查卡：六条高频坑，迁移启动会集中宣讲。
• 平行小项目先行：用完整小功能跑通全流程，再谈核心推进。

问题：非 React 背景的成员（如 Vue 团队）走同一条路吗？

走前半段不同，后半段合流。Vue 背景的成员对信号、派生缓存、依赖自动追踪零障碍（第 2 章几乎是母语），第一段可以直接压缩到半天；需要重点补的是第 3 章——"组件只执行一次"对 Vue 模板心智同样是新事物，以及 JSX 书写习惯。从第二段起，两条背景的路线完全合流。带队时把两套背景分组结对，互教对方熟悉的半边，试点周效率会明显提高。

下一章进入性能专题——基准数据怎么读，优化手法怎么选。