前端工程师从初级到中级的进阶清单:developer-handbook 的 React 技能评估与实践指南

原创2026-10-09 16:22:011,892 阅读
文章标签:文档教程

前端工程师从初级到中级的进阶清单:developer-handbook 的 React 技能评估与实践指南

本文基于 developer-handbook 仓库中的 Technical Guide/Junior to Regular/Frontend Developer.md 编写。它是该仓库 "Technical Guide" 体系中用于评估前端工程师是否具备从初级(Junior)迈向中级(Regular)实力的核心技能清单,覆盖工程协作规范、React 组件与 Hooks、Redux 状态管理、样式体系、路由、HTTP、测试、开发工具等完整主题。读完本文,你将获得一份可逐项自查的进阶路线图:知道每一项技能"是什么、为什么、怎么练",并能在仓库对应的技术栈文档中找到每个知识点的详细依据与延伸材料。

developer-handbook 开发者成长路径架构图:从 Junior 到 Senior 的入职检查清单与技术指南

这份指南在整个手册中的定位

developer-handbook 是一个"如何成为一名专业 Web / Mobile 应用开发者"的主观技术指南(opinionated guide),由 Apptension 团队维护。仓库 README.md 明确说明,Technical Guide 是"按职业等级划分的完整主题列表(库、框架、编程概念/模式)",用于验证你的技术能力以及你在项目中所做的技术决策。

Junior to Regular 这条路径的含义是:一名 Regular(中级)开发者应当掌握 Junior(初级)清单中的几乎全部内容,并具备学习 Regular 清单中技能的能力(见 README.md 的 Q&A 部分)。也就是说,这份文档不是"学了就完"的教科书,而是一份技能验收标准——你可以在项目实战中逐项打勾,用它做职业规划、面试自评或团队 onboarding。

全仓库三套体系的关系如下,本文只聚焦中间那一环:

  • Onboarding(入职两周检查清单,分为 Junior / Regular / Senior)
  • Technical Guide(本文件所在:Junior to Regular 与 Regular to Senior 两套成长指南)
  • Technical Stack(所有生产环境使用主题的总览与详细清单)

工程协作规范:Git 与沟通工具

中级前端工程师的第一步不是写代码,而是用团队认可的方式协作。文档首先列出了工程协作层面的硬性要求(详细条目可对照 Technical Stack/Mobile Developer/Company best practices.md 查阅)。

Git 工作流

  • 创建带规范名称与描述的 Pull Request(PR 名与描述要能让协作者只看标题就明白改动意图);
  • 使用 squash merge 合并 PR,保持主分支历史整洁、可回溯;
  • 以规范方式命名 commit(例如遵循 Conventional Commits 的 feat: / fix: / chore: 前缀习惯)。

这些要求在仓库 公司实践清单 中进一步细化,还包含:review PR 时认真阅读并留下评论、为分支使用 feature / fix / hotfix 等规范目录、为 PR 添加合适的 label,以及在仓库层面为特定分支(master、develop)配置合并保护规则。

GitHub 与沟通工具

  • GitHub:知道如何创建 issue 并在 PR 中引用 issue,能够在构建检查(build check)失败时定位原因(详见 GitHub 小节,还涉及 Wiki 页面与 Bitbucket/Jira 的用法);
  • Slack:按公司政策设置状态(远程办公、休假、开会中),知道如何创建群组与频道;
  • Small Improvements:知道如何给予 praise(公开表扬),并能向 1:1 会议添加讨论话题;
  • Email:能够配置本地邮件客户端。

实践建议:将"PR 命名 → squash merge → commit 规范"固化为肌肉记忆,这部分是晋升考核中成本最低、也最容易被忽略的加分项。

React 核心能力:组件、状态、渲染与生命周期

文档对 React 的定位是:"React 是一个用于构建用户界面的开源 JavaScript 库,由 Facebook 及开发者社区维护,可作为单页应用(SPA)或移动应用开发的基础。"中级阶段需要掌握以下核心能力(详细清单见 React 技术栈文档):

函数组件与类组件的抉择

  • 能够编写函数组件(接收 props、返回 JSX 的纯函数式写法);
  • 理解函数组件与类组件的区别:类组件通过 this.state / 生命周期方法管理状态,函数组件自 Hooks 引入后以更简洁的方式实现同等能力,两者返回的最终产物都是 React element。

本地状态与 Virtual DOM

  • 知道如何定义和修改组件本地 state(useState 或类组件中的 setState,注意状态更新是异步批量处理的);
  • 理解 Virtual DOM 是什么、React 如何用它渲染组件:React 先在内存中维护一棵轻量的虚拟节点树,对比新旧虚拟树(diff)后,只把差异批量应用到真实 DOM,从而减少昂贵的浏览器重排与重绘。

事件与生命周期

  • 会使用元素事件(如 onClick、onChange)并把它们纳入组件生命周期;
  • 理解组件生命周期各阶段(挂载 mount、更新 update、卸载 unmount)的用途。函数组件时代,这些阶段由 useEffect 等 Hooks 承担。

Hooks:useState 与 useEffect

React 文档中的 Hooks 小节 对中级的要求集中在两点:

  • 熟练使用 useState 与 useEffect:useState 管理本地状态并返回 [值, 更新函数];useEffect 执行副作用(订阅、请求、手动 DOM 操作)并支持清理函数;
  • 理解 Hook 依赖数组(dependency array) 的工作方式:useEffect(fn, [dep]) 只有在依赖项变化时才重新执行;空数组 [] 表示只在挂载后执行一次;不传数组则每次渲染都执行。依赖数组写错是导致闭包过期(stale closure)和死循环的常见根源。

进阶项(可在晋升前提前掌握,仓库 React.md 中完整列出):编写自定义 Hook 以复用逻辑、理解 useCallback/useMemo 的利弊(避免不必要的子组件重渲染)、Context API 跨层级传值、refs 绑定原生 DOM 节点、高阶组件(HOC)与 render props 的差异与取舍、Portals 的适用场景,以及通过 React.memo 等手段防止组件不必要的重渲染。

应用状态管理:从 Redux 数据流到中间件

中级前端必须能讲清并实践完整的状态管理链路,仓库的 Application state management.md 给出了非常细的分级要求。

Redux 数据流与 react-redux

  • 能够完整描述 Redux 数据流:dispatch(action) → reducer 根据 action 计算新 state → store 通知订阅者 → 组件基于新 state 重渲染。方向永远单向,这是可预测性的来源;
  • 使用 react-redux 的 useSelector:传入选择器函数,从 store 中挑选组件需要的状态切片;订阅后 store 变化会触发组件重渲染;
  • 使用 useDispatch 在组件中发起 action。

Redux 文档中还有进阶要求:在 React 上下文之外 dispatch action(例如在非组件模块中)、使用 combineReducers 组合多个 reducer、理解 middleware 与 enhancer 的区别(middleware 包装 dispatch 以拦截 action,enhancer 在创建 store 时增强 store 本身),并在创建 store 时正确应用它们。

redux-toolkit:更高效的 reducer 与 action creator

文档要求在 Redux toolset 中至少掌握一个库来高效创建 reducer、action types 与 action creators,首推 redux-toolkit:

  • 知道如何创建 reducer(推荐用 createSlice 定义 reducer + action creators + 初始 state,一个 slice 即一个模块);
  • 知道如何创建 action creator,并利用"action creator 序列化后即 action 的 type 字符串"这一特性简化类型与调试;
  • 了解 slices 的用法,把 state 按领域切分成独立模块(可对照仓库 Application state management.md 的 redux-toolkit 小节 中更长的清单:为特定 action type 定义 reducer 函数、使用 slices)。

不可变数据结构:immer / Immutable.js / seamless-immutable

Redux 要求 reducer 是纯函数、不直接修改 state,因此"不可变(immutable)"是核心素养:

  • 理解在 Redux 中使用不可变数据结构的好处(可预测的更新、可追踪的历史、更易测试与时间旅行调试);
  • immer(推荐):reducer 中可以先写"看起来像修改"的代码(draft 对象),immer 通过 Proxy/拷贝机制把 draft 的修改转译成新的不可变对象。文档还要求理解"只修改 state 对象"与"返回一个修改后的新 state 对象"的区别,并掌握如何将不可变结构转回普通 JS 对象;
  • [可选] Immutable.js:创建与读取不可变结构、基于现有结构"派生"新结构(如 update、set)、配合 redux-immutable 使用、JSON 与不可变结构的互转、大结构操作的性能取舍;
  • [可选] seamless-immutable:理解它与 Immutable.js 的区别(前者基于普通对象/数组、API 更贴近原生、体积更小),以及原生方法(map、sort)与 seamless 方法(flatMap、merge)的协调使用。

selectors 与 reselect

  • 使用 reselect 的 createSelector 创建带记忆化(memoization)的选择器:输入 selector 不变时直接返回缓存结果,避免派生数据在每次渲染时重复计算(详见 Selectors 小节)。进阶:创建组合多个输入 selector 的选择器。

副作用:redux-saga

副作用(side effect)指"函数对外部世界产生影响"的操作——网络请求、定时器、写本地存储等。中级要求理解副作用概念,并用 redux-saga 管理:

  • 理解 Generator(function*)概念,saga 本质上是基于 Generator 的副作用编排器;
  • 用 take 等待某个 action、用 put 在副作用完成后 dispatch 另一个 action(即"基于副作用派发 action");
  • 在某个 action 派发后运行异步函数(如 fetch);
  • 在 saga 内部用 select 从 Redux state 中读取数据;
  • 用 all 并行执行多个 saga / call 顺序执行,掌握 saga 的编排;
  • 进阶:eventChannel(订阅外部事件源,如 WebSocket)与 actionChannel(缓冲 action 以控制并发)的使用场景与实现。

仓库中还有 redux-saga-routines(标准化的 routine 生成、payloadCreator 操作 payload、metaCreator 增强 payload)与 redux-persist(将 state 树部分持久化到本地存储)等可选掌握项,详见 Application state management.md。

Apptension React Boilerplate:公司级工程实践

这是把上述抽象能力落到真实工程的关键一节。文档要求掌握基于 Apptension React 模板(create-react-app generator 的模板)的日常开发动作(详细条目见 Apptension React Boilerplate.md):

  • 使用 Apptension React 模板初始化一个新项目;
  • 运行 linter(代码规范检查,对应 eslint / prettier / stylelint 工具,见下文"开发工具");
  • 定义一个新的 Redux 模块(Reducer、Saga、Selector 三件套);
  • 创建新路由及其组件;
  • 理解 src/routes(页面级路由组件)与 src/shared/components(可复用共享组件)目录的职责区别;
  • 使用 plop 自动生成模块与组件模板;
  • 知道翻译文件存放位置、如何新增 locale、以及用 extract-intl 脚本抽取翻译串。

意义:Boilerplate 是把"规范"固化为"脚手架"的载体——新模块不是手写的,而是通过约定与生成器产出的,从而保证团队代码结构一致、评审成本最低。

样式体系:CSS 基础到 styled-components、Flexbox 与 Grid

仓库 Styling.md 给出了完整的样式能力清单,中级要求覆盖从原生 CSS 到组件化样式的全链路。

原生 CSS

  • 会写 CSS 规则;能对元素应用基础样式(颜色、尺寸、位置等);
  • 能正确显示与按比例缩放图片(如 aspect-ratio 盒子技巧);
  • 能水平 + 垂直居中元素;
  • 会使用 media queries 做响应式适配。

CSS-in-JS:styled-components

  • 能为一个原生元素创建 styled component(如 const Button = styled.button\...``);
  • 能扩展已有组件的样式(styled(Button));
  • 进阶(仓库清单中列出):全局样式、在 styled 中实现 media queries、通过 classnames 给只支持 className 样式的第三方组件套样式、用 styled-theming 实现主题模式与主题变体(如暗色模式)。

Flexbox 与 CSS Grid

  • Flexbox:掌握 flex-direction 的 row / column 布局、子元素的对齐(justify-content / align-items / align-self)、子元素拉伸到父级尺寸、flex-basis 与 flex-wrap 的正确使用;注意不同浏览器间 flex 简写语法的差异以及 flexbugs 中的已知坑;
  • CSS Grid:能将页面划分为行与列、在网格中定位元素;进阶包括命名网格区域(grid-template-areas)与单元格内对齐。

可选:Sass 与 UI Kits

  • [可选] Sass:理解 SCSS 语法与文件扩展名(.scss)、创建与使用 scss 变量、mixin 与运算符;
  • UI Kits:至少理解一个 UI Kit 库的基础用法(如 Material-UI 的安装与使用、主题 API、组件样式定制;或 antd),并在项目中使用过。

日期与时间处理

前端处理日期/时间的高频需求是"格式化展示"与"比较/运算",仓库 Date & Time.md 的要求分两层:

  • 原生能力:为指定日期创建 Date 对象、比较原生 Date 对象(注意比较的是毫秒时间戳);
  • 工具库(三选一或全掌握):
    • [可选] react-datetime:用标准格式字符串格式化与展示日期对象;
    • [可选] moment.js:格式化展示(format('YYYY-MM-DD'));
    • [可选] dayjs:轻量级替代,同样支持标准格式字符串格式化、时区转换、比较与运算。

进阶(可提前掌握):ISO 8601 标准格式的解析、unix timestamp 与 Date 的互转、date-fns 的按需导入与用户本地时区转换。

路由:react-router 与 react-router-dom

仓库 Routing.md 列出中级路由能力,核心是 SPA 多页面组织的两大库:

react-router

  • 用 Switch 与 Route 搭建简单路由结构(Switch 保证只渲染第一个匹配的 Route);
  • 为路由添加参数,并区分必选参数与可选参数(path="/users/:id" 与 path="/users/:id?" 之类);
  • 用 exact 精确匹配路由,避免前缀误匹配;
  • 渲染 404 页面(未匹配到任何 Route 时渲染兜底组件);
  • 用 <Redirect> 在特定场景下把用户重定向到需要的组件;
  • 进阶(仓库列出):通过 browser router 与浏览器历史交互、使用 useNavigate / useLocation / useParams / useMatch 等路由 Hooks、操作 history 的 location 对象、分离公共路由与私有路由、根据用户权限安全地渲染路由。

react-router-dom

  • 会使用基础导航组件 Link(声明式跳转)与 NavLink(带激活态样式)。

动画、国际化与音视频基础

  • CSS 动画:会写 transitions(过渡)与 keyframes(关键帧)动画,详见 Animations.md;
  • 国际化:会使用 react-intl 的组件(<FormattedMessage> 等)做文案翻译与格式化,见 Internationalization.md;
  • 音视频:知道如何使用标准 HTML <audio> 与 <video> 标签。

开发工具:构建、包管理、生成器与调试

中级工程师的工具素养由 Development Tools.md 定义,分为以下几组。

构建工具:Webpack

  • 理解 webpack 的用途与解决的问题(模块打包、资源处理、代码拆分、开发服务器等);
  • 掌握四大核心概念:entry(入口)、output(输出)、loaders(转换器)、plugins(插件);
  • 知道如何向应用传递环境变量,并能从零配置一份可生成项目构建产物的 webpack 配置。

包管理器:Yarn 与 NPM

  • 能用行内命令添加、安装、移除包(Yarn:yarn add / yarn install / yarn remove;NPM:npm i / npm uninstall);
  • 理解 yarn.lock / package-lock.json 的价值:锁定依赖树,保证团队成员与 CI 环境安装到完全一致的版本;
  • 会运行 package.json 脚本(yarn run / npm run)、定义新的 scripts、升级依赖(Yarn 的 upgrade-interactive)、初始化与发布新包。

生成器:create-react-app

  • 能用 create-react-app CLI 生成新应用;进阶:创建并发布自己的 CRA 模板;仓库还列出 plop.js 用于命令行生成组件并维护模板。

React 生态工具

  • prop-types:描述组件 props 的类型,能定义对象形状(PropTypes.shape({...}))——在 TypeScript 全面铺开前这是组件契约的主要手段;
  • redux-devtools:用它查看当前 state 并回放/回退状态变更历史,前提是 store 已按规范配置为可被检查;
  • 进阶:Storybook(组件原型开发与主题接入)、react-hot-loader(组件热更新)。

Linters 与环境变量

  • eslint:运行并修复警告与错误,能增删规则;
  • prettier:运行并自动修正格式错误,能配置规则;
  • stylelint:在构建工具中配置样式 lint,按项目需求加规则与例外;
  • dotenv:通过 env 文件注入环境变量,并知道哪些 env 文件该提交、哪些不该提交(如含密钥的 .env 必须 gitignore)。

HTTP 与网络请求:fetch、Axios 与 WebSocket

仓库 HTTP.md 定义了网络层能力,中级要求掌握请求原理与两大请求工具。

基础概念

  • 知道 cookies 是什么(服务端下发的会话数据);
  • 知道 HTTP headers 是什么(请求/响应的元数据);
  • 进阶:CORS 及其局限性、HttpOnly cookie、HTTPS 请求中哪些部分被加密、常见 content-type 值的选用场景。

fetch(原生)

  • 用原生 fetch 发起 HTTP 请求(fetch(url, { method, headers, body }),注意它返回的是 Promise 且只在网络层失败时 reject,HTTP 4xx/5xx 需要手动检查 res.ok);
  • 会在请求中设置 HTTP headers(headers: { 'Content-Type': 'application/json', ... });
  • 进阶:读取响应头、优雅处理 HTTP 错误、取消请求(AbortController)。

Axios

  • 用 axios 向 API 端点发请求,并在请求中设置 headers;
  • 配置预定义的 baseURL(axios.create({ baseURL }))避免每个请求重复写完整路径;
  • 为请求头附加元数据(如 JWT token);
  • 用 transformResponse / transformRequest 转换数据、用 paramsSerializer 序列化参数;
  • 使用 interceptors(请求/响应拦截器,适合统一注入 token、统一错误处理);
  • 处理响应错误、读取响应头、取消请求。

WebSocket 与工具库

  • 会用原生或现成库建立 WebSocket 连接(如 pusher-js 的订阅/退订频道、绑定/解绑事件);
  • 工具库:humps(camelize/decamelize 键名)、query-string(URL 解析与查询串构造)、normalizr(定义实体 schema 并归一化服务端数据,说明其收益)、http-status-codes(用语义化状态码常量替代数字字面量)。

仓库在 HTTP.md 的 Axios 条目中直接以 Apptension 的 cra-template-apptension 中 src/modules/users/users.sagas.ts 作为学习范例——这印证了"saga 中编排 axios 请求"是公司级标准做法:dispatch action → saga call(axios.get) → put 成功/失败 action。

测试:jest 与组件/函数测试

中级测试能力在 Testing.md 中定义为:

  • 用 jest 测试组件与函数(describe / it / expect,配合 @testing-library/react 的 render 与查询方法按可访问性查询元素);
  • 进阶(仓库列出,可提前掌握):测试自定义 React Hooks(renderHook)、测试 selector 函数、jest 中 mock 函数与全局对象、snapshot 测试、react-testing-library 的安装配置与 mock 服务端响应、jest-styled-components 断言样式与可读快照、redux-saga-test-plan 测试 saga 派发的 action 与初始 state、nock 模拟 API 调用、mockdate 冻结时间。

设计与浏览器基础工具

  • 设计协作:能从设计稿提取样式值(几何、颜色、字体等)与图片资源——Figma(必选)、Zeplin(必选),<a href="https://link.gitcode.com/i/c291796d9f4861a0f7f05765cea3b431" target="_blank">可选] Invision、[可选] Adobe XD,详见 [Tools.md;
  • 浏览器:知道 DOM 是什么(浏览器把 HTML 解析成的文档对象模型,是 JS 操作页面的接口),见 Browsers.md。

如何使用这份清单:自评、规划与贡献

  1. 逐项自评:把每个复选框当作一次"能不能当场演示/讲解"的面试题。能讲清原理并能写最小可运行示例的,才勾选。
  2. 结合技术栈文档深化:本文每节都给出了仓库内对应文档的链接,勾选前先回到 Technical Stack/Frontend Developer.md 及对应子文档,确认该项的完整要求(很多项在技术栈文档中比本指南更细)。
  3. 对照 Onboarding 清单:如果想看"入职前两周学什么",可对照 Onboarding/Junior/Frontend%20Developer.md;晋升考核则是"Junior 清单几乎全掌握 + Regular 清单具备学习能力"的组合。
  4. 贡献与修正:仓库欢迎以 pull request 形式扩展或调整清单条目,由技术团队验证后合入主文档;发现错误可提交到 Issues(见 CONTRIBUTING.md 与各文档末尾的 Contribution 小节)。

小结

从初级到中级,前端工程师的核心跃迁在于:从"会写组件"到"能驾驭完整工程"——用规范的 Git 流程协作、用函数组件与 Hooks 组织 UI、用 Redux + redux-saga 管理可预测的状态与副作用、用 styled-components 与 Flexbox/Grid 构建一致的样式体系、用 react-router 组织页面、用 axios 与测试保障网络与质量。developer-handbook 的这份清单把上述能力拆成了可勾选、可验证、可复习的最小单元,而本文与仓库中每一份 技术栈文档 则为你提供了逐项深入的地图。逐条攻克,Regular 即在眼前。

登录后查看全文
developer-handbook