developer-handbook 高级前端工程师技能清单:React 工程化、状态管理与协作规范实战指南

原创2026-10-09 19:25:591,933 阅读
文章标签:文档教程

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 是高级前端开发者的上岗能力清单,它不再聚焦"会不会写组件"这类入门问题,而是要求候选人同时具备三方面的素养:

  1. 团队协作与安全规范:会管理密钥、遵守 Git 协作流程、正确使用协作工具;
  2. 框架与工程化深度:吃透 React 渲染机制与 Hooks、掌握 Redux 全链路状态管理、熟练使用 Apptension 团队维护的 React Boilerplate;
  3. 周边技术视野:样式方案选型、路由与国际化、构建与包管理工具、函数式编程、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 等)渲染本地化文案;
  • 使用 defineMessage API 创建消息文件——该能力与本仓库引用的 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-app CLI 生成新应用;
  • 使用 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 团队维护,任何团队都可以基于它构建属于自己公司的开发者手册。

登录后查看全文
developer-handbook