developer-handbook 高级前端工程师技能清单:React 工程化、状态管理与协作规范实战指南
developer-handbook 高级前端工程师技能清单:React 工程化、状态管理与协作规范实战指南
本篇技术指南基于 developer-handbook 仓库中的 Onboarding/Senior/Frontend Developer.md 技能清单展开,面向已具备前端开发基础、正在向高级(Senior)工程师迈进的开发者。读完本文,你将掌握一份覆盖公司工程实践、React 核心机制、Redux 状态管理全家桶、样式体系、路由、国际化、构建工具、函数式编程与 HTTP 通信等维度的完整能力地图,并能在实际项目中对照清单逐项自检、补齐短板。
这份清单在项目中的定位:从 Junior 到 Senior 的能力阶梯
developer-handbook 采用分角色、分职级的文档组织方式:Onboarding 目录下按 Junior / Regular / Senior 三个职级划分,每个职级下又有 Backend、DevOps、Frontend、Mobile 四个方向。本文对应的 Onboarding/Senior/Frontend Developer.md 是高级前端开发者的上岗能力清单,它不再聚焦"会不会写组件"这类入门问题,而是要求候选人同时具备三方面的素养:
- 团队协作与安全规范:会管理密钥、遵守 Git 协作流程、正确使用协作工具;
- 框架与工程化深度:吃透 React 渲染机制与 Hooks、掌握 Redux 全链路状态管理、熟练使用 Apptension 团队维护的 React Boilerplate;
- 周边技术视野:样式方案选型、路由与国际化、构建与包管理工具、函数式编程、HTTP 客户端、DNS 与设计协作等支撑日常开发的硬技能。
同级的 Onboarding/Regular/Frontend Developer.md 解决的是"能独立完成业务功能",而本文所代表的 Senior 清单解决的是"能主导架构、把控质量、指导他人"。
公司工程实践:安全、Git 与沟通
高级工程师首先应当是可靠的协作者。原清单在 Company practices 一节列出了三类必须掌握的公司级实践。
安全实践:密钥的安全共享
- Keeper Security:能够使用团队密码管理工具向同事安全地共享密钥值(secret values)。在公司内部,数据库口令、第三方 API Key 等敏感信息不应通过聊天工具明文传递,而是通过 Keeper 的受控共享机制分发。
- Onetimesecret:当需要把密钥共享给公司外部人员时,使用一次性密钥服务——链接只允许被查看一次,阅后即焚,避免敏感信息在外网长期留存。
这两项能力对应 Technical Stack/Mobile Developer/Company best practices.md 中的 Security 小节,属于所有职级通用的安全基线。
Git 协作规范
- 规范的 Pull Request:为 PR 编写有意义的标题与描述,说明改动动机、影响范围与验证方式;
- Squash Merge:合并 PR 时将多个琐碎提交压缩为单个语义化提交,保持主干历史干净、可追溯;
- 规范的提交信息:遵循统一的 commit message 约定(如 type 前缀 + 简述),让
git log可读; - 认真进行代码评审:Review 他人 PR 时逐行检查并留下具体、可执行的评论;
- 仓库分支保护规则:能够在仓库(如 master、develop)上配置合并规则——例如强制 PR 通过审查后才能合并、CI 检查必须通过。
Bitbucket 与 Jira 的联动
使用 Bitbucket 时,需要在 commit message 中引用对应的 Jira 工单号(例如 PROJ-123: 修复登录页白屏),实现代码提交与需求/缺陷的自动关联,方便回溯每行代码的来源需求。
沟通工具:Slack
按照公司政策维护 Slack 状态(远程办公、休假、会议中等),让团队随时了解你的可协作状态,这是远程/混合办公环境下的基本素养。
React 核心能力:从组件到渲染机制
React 部分是高级前端必须"讲得清楚、写得出来"的硬核区,对应 React 文档。清单要求的核心条目如下:
- 编写函数组件:函数组件以普通函数接收
props并返回 React 元素,是现代 React 的首选写法; - 函数组件与类组件的区别:函数组件无
this绑定、无实例生命周期方法,通过 Hooks 获得状态与副作用能力;类组件则依赖this.state与componentDidMount等生命周期方法,二者在渲染输出上可等价,但心智模型与复用方式不同; - 定义与修改本地组件状态:类组件用
this.setState,函数组件用useState,需理解状态更新是异步合并的; - Virtual DOM 与渲染原理:React 在内存中维护一棵虚拟节点树,状态变化时先 diff 新旧虚拟树,再将最小差异批量提交到真实 DOM,这是 React 高性能渲染的根基;
- 元素事件与生命周期的结合:为元素绑定事件(如
onClick)并理解事件处理在渲染周期中的触发时机,避免在渲染函数中执行副作用。
Hooks:useState 与 useEffect
清单对 Hooks 的要求非常具体:
- useState:声明并更新组件局部状态,
const [count, setCount] = useState(0); - useEffect:执行副作用(数据请求、订阅、DOM 操作),并在依赖变化或卸载时清理;
- 依赖数组(dependency array):
useEffect的第二个参数决定副作用何时重跑——空数组表示仅在挂载时执行,传入依赖项则在其变化时执行。这是高级开发者最容易踩坑也最需要讲清楚的概念:依赖数组漏写或误写会导致闭包捕获过期值或副作用无限循环。
进阶到 Senior 还应掌握自定义 Hook 的封装、useCallback/useMemo 的适用场景与代价,以及 react-use 这类实用 Hook 库在组件中的接入方式(详见 Technical Stack/Mobile Developer/React.md)。
应用状态管理:Redux 全链路
状态管理是前端工程的深水区,原清单对应 Application state management 文档,要求 Senior 能完整讲清并落地 Redux 体系。
Redux 基础流程
- 能描述完整的 Redux 数据流:组件 dispatch action → reducer 根据 action.type 生成新 state → store 通知订阅者 → 组件通过 selector 取到新状态并重渲染;
- 掌握
combineReducers拆分状态树、为 store 应用中间件与 enhancer,并能说清二者的区别(中间件包裹 dispatch 流程,enhancer 扩展 store 本身)。
react-redux:Hooks 接入
- useSelector + selector 函数:从 store 中选取组件需要的状态切片,注意 selector 返回值的引用稳定性会影响重渲染;
- useDispatch:在组件内派发 action,替代老的
connect高阶组件写法。
Redux Toolkit:现代 Redux 的标准工具
清单要求能利用工具集高效创建 reducer 与 action creator:
- 用
createSlice同时定义 reducer、action type 字符串与 action creator; - 理解 action creator 序列化为 action 的
type字符串这一特性,从而可以在 saga、selector 等处按类型统一处理; - 能针对特定 action type 定义 reducer 分支,并善用 slices 组织领域状态模块。
不可变数据结构与 immer
- 理解 Redux 中不可变数据的好处:可预测的状态变更、可回溯的时间旅行调试、组件可按引用快速判断是否需要重渲染;
- immer:在 reducer 中通过"改草稿"的直观写法生成不可变的新状态(
produce包裹),无需手写展开运算符嵌套,显著降低深层更新心智负担;还需理解只修改 state 对象与返回新 state 对象的区别,以及 immer 内部基于 Proxy 的实现原理。
Selectors:reselect
使用 createSelector 创建可组合、可记忆化(memoized)的选择器,并支持以多个其他 selector 的结果作为输入,用于派生数据与避免昂贵计算。
副作用:redux-saga
- 理解副作用(side effect)概念:函数与外界交互(网络、存储、日志)带来的不可预测行为;
- put:在 saga 中派发 action,实现"监听到某个 action 后触发副作用并派发新 action"的流程;
- select:在 saga 内部通过 selector 读取当前 Redux 状态;
- 底层依赖 JavaScript 生成器(generator)机制:saga 函数用
yield挂起、用take等待其他 action,并支持串行/并行编排多个 saga。
Apptension React Boilerplate:团队工程化基座
这是本仓库背后团队(Apptension)沉淀的实战工程模板,对应 Apptension React Boilerplate 文档。Senior 前端入职后需要立即能在该脚手架上工作:
- 初始化项目:使用
create-react-app生成器的 Apptension React 模板创建新项目; - 运行 linter:执行 lint 命令检查代码规范并修复告警;
- 定义新的 Redux 模块:按模板约定同时产出 Reducer、Saga、Selector 三件套,保持模块自洽;
- 创建新路由及其组件:在路由层注册路径并挂载对应页面组件;
- 理解
src/routes与src/shared/components的区别:前者存放按页面/路由组织的业务容器,后者存放可跨页面复用的共享 UI 组件; - 使用 plop 生成模块与组件:通过脚手架命令一键生成标准文件骨架,保证团队代码风格一致;
- 国际化工程:知道翻译文件存放位置、如何新增 locale,并能运行
extract-intl脚本从代码中抽取待翻译文案。
样式体系:从基础 CSS 到工程化选型
样式部分对应 Styling 文档,覆盖基础、组件级与布局三个层次。
CSS 基础能力
- 编写 CSS 规则并对元素应用颜色、尺寸、定位等基础样式;
- 正确显示与等比缩放图片(如利用 aspect-ratio 盒子);
- 水平垂直居中元素的多种方案;
- 使用媒体查询(media queries)实现响应式;
- 通过
@font-face添加与使用网络字体(webfonts)。
CSS-in-JS:styled-components
- 为原始元素创建 styled component;
- 扩展已有组件的样式:
styled(Button)派生新组件; - 应用全局样式(
createGlobalStyle); - 在 styled-components 中实现媒体查询;
- 能对仅支持类名注入的第三方组件应用样式。
Flexbox 布局
- 使用
flex-direction: row/column构建行列布局; - 对齐子元素(
justify-content、align-items、align-self); - 让子元素拉伸至父容器尺寸;
- 正确使用
flex-basis与flex-wrap控制主轴尺寸与换行。
UI Kits
至少理解一种 UI Kit 库的基础用法(如 Material-UI),并能在项目中落地使用;进阶还涉及主题 API、组件样式与行为定制(详见 Styling)。
日期与时间:date-fns
日期处理是极易出错的前端细节,对应 Date & Time 文档:
- 能为特定日期创建 JavaScript
Date对象; - 使用 date-fns 创建日期对象;
- 使用标准格式字符串(format tokens,如
yyyy-MM-dd)格式化并展示日期。
路由:react-router 与 react-router-dom
路由对应 Routing 文档:
- 使用
Switch与Route搭建基础路由结构; - 为路由添加参数并区分必选/可选参数;
- 精确匹配所需路由(
exact语义); - 渲染 404 页面;
- 通过 history API 与浏览器历史交互;
- 使用基础路由 Hooks:
useHistory、useLocation、useParams、useRouteMatch; - 在
react-router-dom中使用Link、NavLink组件进行声明式导航。
动画:CSS Animations
对应 Animations 文档,要求能编写 CSS 动画——包括 transition(过渡)与 keyframes(关键帧动画),在不过度引入动画库的前提下实现交互动效。
国际化:react-intl
对应 Internationalization 文档:
- 熟练使用 react-intl 组件(
FormattedMessage、FormattedNumber等)渲染本地化文案; - 使用
defineMessageAPI 创建消息文件——该能力与本仓库引用的cra-template-apptension模板中src/routes/home/home.messages.ts的用法一脉相承,配合 Apptension Boilerplate 一节的extract-intl脚本即可形成"定义消息 → 抽取文案 → 翻译 → 多语言渲染"的完整闭环。
开发工具:构建、包管理、生成器与质量工具
对应 Development Tools 文档,这是 Senior 日常工程效率的根基。
构建工具:Webpack
- 理解 webpack 解决的痛点(模块打包、依赖图、代码分割、资源处理);
- 理解并会配置核心概念:entry(入口)、output(出口)、loaders(转换器)与 plugins(插件);
- 能按需添加并配置插件(如
HtmlWebpackPlugin); - 会向应用注入环境变量。
包管理器:Yarn 与 NPM
- 能使用内联命令安装、移除与更新包(
yarn add/remove、npm install/uninstall); - 理解
yarn.lock/package-lock.json的作用:锁定依赖树,保证团队与 CI 环境构建一致; - 会运行
package.json中的 scripts(yarn run/npm run); - 会定义新的 scripts、升级依赖、初始化并发布新包。
生成器:create-react-app 与 plop.js
- 使用
create-react-appCLI 生成新应用; - 使用 plop 命令行工具创建组件,并能维护/更新生成模板——这与 Apptension Boilerplate 的脚手架工作流直接呼应。
React 配套工具
- prop-types:为组件描述 prop 类型(含对象结构 shape),提升组件接口的自文档性与健壮性;
- redux-devtools:使用 Redux DevTools 查看当前状态、回放状态变更历史,是调试 Redux 应用的核心工具。
代码质量:eslint 与 prettier
- 运行 eslint 并修复告警与错误,能按需增删规则;
- 运行 prettier 并自动修正格式错误,保持团队代码风格统一。
函数式编程:ramda
对应 Functional programming 文档,要求掌握函数式核心概念:纯函数(相同输入必有相同输出)、无副作用、不可变性、一等函数、引用透明与递归。在 ramda 层面:
- curry(柯里化):将一个多参数函数转换为可逐次传参的嵌套函数;
- compose / pipe:从多个函数组合出新的处理流程——
compose从右向左、pipe从左向右形成逐步处理序列; - 熟练使用基础函数:
map、mapValues、find、sort、sortBy、concat、equals、cond、ifElse等,在数据处理管线中写出声明式、无副作用的代码。
HTTP 请求:fetch 与 axios
对应 HTTP 文档:
原生 fetch
- 使用原生
fetch发起 HTTP 请求; - 处理 HTTP 响应返回的错误(非 2xx 状态需显式抛错)。
axios
- 使用 axios 向 API 端点发送请求;
- 处理响应错误;
- 配置预定义 baseURL:
axios.create({ baseURL: 'https://api.example.com' }),让所有请求共享同一根路径; - 进阶能力(详见 HTTP):设置请求头、读取响应头、通过拦截器(interceptors)统一注入 JWT 等元数据、
transformRequest/transformResponse数据转换、paramsSerializer参数序列化、请求取消等——这些正是真实业务中鉴权、错误统一处理、请求取消的标准解法。
字体加载:Google Fonts
对应 Fonts 相关实践,要求能在 React 项目中加载 Google Fonts 提供的自定义网络字体(引入样式表或通过 @font-face 自托管),保证跨平台字体渲染一致。
后端与 DevOps 基础:DNS
前端工程师同样需要基本的域名与部署认知,对应 Backend & DevOps 文档:
- 理解 CNAME 记录(别名指向)及使用时机(如将子域名指向托管服务);
- 理解 A / AAAA 记录:将域名解析到 IPv4 / IPv6 地址;
- 理解 TXT 记录:存放域名验证、SPF 等文本信息;
- 会通过所选域名注册商(DNR)注册新域名;
- 会将 NS(名称服务器)从注册商默认值切换至其他 DNS 提供商。
设计协作:Figma
对应 Tools 文档,Senior 前端应能直接从设计稿中提取实现要素:
- 从设计项目提取样式值(几何、颜色、字体等);
- 导出图片资源;
- 导出矢量图标资源。
这保证"设计 → 前端"的高效衔接,避免反复沟通取值。
结语:以清单为纲,向团队持续反哺
这份 Senior 前端清单覆盖了从"写对组件"到"管好状态、建好工程、当好协作者"的完整进阶路径。你可以将 Onboarding/Senior/Frontend Developer.md 作为个人能力自检表逐项打勾,并结合 Technical Stack 目录下 Frontend / Mobile 两个方向的细分文档深入学习每个专题。本手册本身是开放的:如果你在实践中发现清单需要增补或修正,欢迎通过 Pull Request 提交,由技术团队验证后合入主文档;如发现问题也可在 Issues 中反馈。手册遵循 MIT 许可证,由 Apptension 团队维护,任何团队都可以基于它构建属于自己公司的开发者手册。