用途
该技能用于审查 SolidJS 代码中的 React 反模式(资料称 React contamination),也可用于把 React 组件转换为 SolidJS 的场景。资料强调,被 React 训练的 AI 助手生成 SolidJS 代码时容易引入这些问题,其中解构 props 被列为最严重的来源之一。
主要能力
资料将反模式整理为编号表格(AP-001 至 AP-023),每项标注严重程度(CRITICAL / HIGH / MEDIUM / LOW)与检测特征,例如:
- AP-001 解构 props:CRITICAL,检测特征为
function X({ prop }或const { x } = props - AP-002 解构 Signal 值:CRITICAL,
const val = signal()出现在 JSX/effect 之外 - AP-003 用 useState 代替 createSignal:CRITICAL
- AP-004 用 useEffect 代替 createEffect:CRITICAL,或出现
[deps]数组 - AP-005 用 useMemo 代替 createMemo:HIGH
- AP-006 假设组件会重新渲染:CRITICAL
- AP-007 有条件地访问 Signal:HIGH
- AP-008 在读取 Signal 前提前 return:HIGH
- AP-009 把 Signal 存入变量:HIGH
- AP-010 不安全地展开 props:MEDIUM
- AP-011 用 Array.map 渲染列表:HIGH
- AP-012 用三元表达式代替 Show:MEDIUM
- AP-013 组件体内使用 switch/case:HIGH
- AP-014 列表项上的 key prop:LOW
- AP-015 用 useRef 代替 let ref:MEDIUM
- AP-016 假设存在 React.createElement:LOW
- AP-017 children 当作静态值:HIGH
- AP-018 effect 返回清理函数:CRITICAL
- AP-019 useRouter / next/router:HIGH
- AP-020 用 useEffect 做数据获取:HIGH
- AP-021 Route 上的 element prop:HIGH
- AP-022 getServerSideProps 模式:HIGH
- AP-023 表单 onSubmit 中调用 preventDefault:MEDIUM
关键规则(摘自资料)
- 永远不要在 SolidJS 组件中解构 props:解构会切断响应式代理连接,组件函数只运行一次,解构出的值是永不更新的冻结快照。应直接访问
props.name,或在需要拆分时使用 splitProps。 - 永远不要假设组件会重新渲染:组件函数只执行一次以搭建响应式图,依赖状态变化的代码必须包裹在响应式原语中(createMemo、createEffect)或写成内联 JSX 表达式。
- 永远不要使用依赖数组:SolidJS 自动追踪依赖,createEffect 与 createMemo 没有
[deps]参数。 - 永远不要从 effect 返回清理函数:应改用 onCleanup() 在 effect 内单独调用。
- 永远不要用 Array.map() 渲染列表:应在数组变化时重建所有 DOM 节点,改用
<For>或<Index>。
使用方式
资料提供了一棵决策树,用于逐项判断代码是否命中反模式,从“代码中是否包含 signal/props 访问”开始,依次检查 props 解构、Signal 值存入 const、useState/useEffect/useMemo 导入、依赖数组、组件体内非响应式派生值、effect 提前 return、条件访问 Signal、effect 返回清理函数、JSX 中的 Array.map()、key prop、useRef/.current、props.children、useRouter 导入等。
资料还引用三个参考文件:references/methods.md(每个反模式的检测规则与正则模式)、references/examples.md(每个 AP-NNN 的错误与正确写法对照)、references/anti-patterns.md(含检测与修复的综合速查表)。具体安装命令、调用方式与运行步骤在资料中暂未提供。
适用场景
- 审查已有 SolidJS 代码,排查 React 风格写法
- 将 React 组件转换为 SolidJS 时做对照检查
- 校验 AI 生成的 SolidJS 代码是否符合其响应式模型
限制
资料中引用的官方文档链接包括:
- https://docs.solidjs.com/concepts/intro-to-reactivity
- https://docs.solidjs.com/concepts/components/props
- https://docs.solidjs.com/concepts/signals
- https://docs.solidjs.com/concepts/effects
- https://docs.solidjs.com/reference/basic-reactivity/create-signal
- https://docs.solidjs.com/reference/basic-reactivity/create-effect
- https://docs.solidjs.com/reference/basic-reactivity/create-memo
- https://docs.solidjs.com/reference/components/for
- https://docs.solidjs.com/reference/components/show
关于该技能的收费、价格、支持的平台与具体使用步骤,资料中暂未提供。