Developer Handbook:初级前端工程师(Junior Frontend Developer)技能清单与实践指南
Developer Handbook:初级前端工程师(Junior Frontend Developer)技能清单与实践指南
本指南基于 developer-handbook 仓库中的 初级前端工程师入职清单,系统梳理了成为一名合格初级前端工程师所需掌握的全部技术点:从 Git 协作规范、React 组件与 Hooks 基础,到 Redux 状态管理、路由、样式、国际化、构建工具与 HTTP 请求,再到 Figma 设计资源提取。读者读完本文,将能对照清单逐项自检技能缺口,并获得每个知识点的深入讲解、代码示例与仓库内部参考文档,为入职第一周快速上手打下坚实基础。
一、清单概览:这份文档解决什么问题
这份文档是 Apptension(以及其维护的 Developer Handbook 社区)为初级(Junior)前端工程师设计的"入职两周技能清单"(Onboarding Checklist)。它的定位不是一本教科书,而是一份可勾选的验收标准:每一条都是一项具体、可验证的技能,例如"你知道如何写一个函数组件"、"你知道如何使用 useState 和 useEffect"。
仓库 README.md 明确指出:Onboarding 指开发者入职后头两周内应掌握的内容,这份清单由公司技术团队维护,同时也接受社区的 Pull Request 贡献与 Issues 反馈。因此,本文不仅服务于加入该公司的开发者,也适合任何想以"初级前端工程师"标准要求自己的学习者——你完全可以 fork 本仓库,把它当作自己的学习路线图。
从清单结构看,Junior 前端工程师的技能域分为以下几条主线:
| 主线 | 覆盖主题 | 核心工具/技术 |
|---|---|---|
| 工程协作 | 公司实践(Git、沟通) | Pull Request、Slack |
| UI 基础 | React 组件、Hooks、生命周期 | React、Virtual DOM |
| 状态管理 | Redux 生态、不可变数据、副作用 | Redux、react-redux、redux-toolkit、immer、reselect、redux-saga |
| 项目脚手架 | Apptension React Boilerplate | create-react-app 模板 |
| 样式 | CSS、CSS-in-JS、Flexbox、UI Kit | styled-components、material-ui |
| 日期与路由 | Date 对象、路由结构 | Date、react-router |
| 动画与国际化 | CSS 动画、多语言 | CSS transitions/keyframes、react-intl |
| 工程工具 | 构建、包管理、脚手架、组件检查 | webpack、yarn/npm、create-react-app、prop-types、redux-devtools |
| 网络通信 | HTTP 请求库 | fetch、axios |
| 设计协作 | 设计稿取色、取图 | Figma |
下面按清单顺序,逐模块展开讲解并给出可落地的示例。
二、公司实践:Git 与沟通的工程协作规范
清单开篇的"Company practices"看似与编码无关,却是团队协作的地基。它引用的是仓库中的 Company best practices.md 文档(Junior 清单中聚焦 Git 与 Slack 两条子项)。
2.1 Git:让代码审查可读、可追踪
初级工程师需要建立三条 Git 协作习惯:
- 创建命名与描述规范的 Pull Request:PR 标题应一句话概括改动意图,描述区说明"为什么改、怎么改、如何验证",让评审者不需要猜测上下文。
- Squash Merge 你的 PR:将开发过程中的多次提交合并为一条语义清晰的提交,保持主干历史线性、可读。团队文档中还强调理解
git rebase与git merge的取舍(Company best practices.md 中有完整条目)。 - 规范命名提交信息:例如遵循 Conventional Commits 风格(
feat: ...、fix: ...、chore: ...),让提交历史本身成为文档。
值得注意的是,仓库中的 Company best practices.md 对 Git 实践有更完整的条目(如 PR 评审后留下评论、在 feature/fix/hotfix 分支目录下建分支、在仓库中为 master/develop 配置合并规则等),Junior 阶段先掌握前三条,其余条目会在成长过程中逐步补齐。
2.2 沟通:Slack 状态
- 清单要求你按照公司政策使用 Slack 状态:远程办公、休假、开会等场景都要通过状态对外可见,减少团队协作中的信息盲区。这是"分布式团队透明度"的最小实践。
三、React 基础:从函数组件到渲染原理
清单为 React 部分写了一段背景介绍:React 是一个开源 JavaScript 用户界面库,由 Facebook(Meta)与开发者社区共同维护,可用来构建单页应用(SPA)或移动应用。围绕这个定位,Junior 需要掌握以下五件事(对应 React.md 文档的核心条目):
- 写函数组件:函数组件是接收 props 并返回 JSX 的纯函数,是当前 React 的主流写法。
- 区分函数组件与类组件:函数组件无
this绑定、无自己的生命周期方法(由 Hooks 替代),类组件需要extends React.Component并实现render()。 - 定义与修改组件局部状态:函数组件用
useState,类组件用this.state+this.setState()。 - 理解 Virtual DOM 及 React 的渲染机制:React 在内存中维护一棵虚拟 DOM 树,状态或 props 变化时先计算差异(diff),再批量更新真实 DOM,从而提升渲染性能。
- 使用元素事件并融入生命周期:例如
onClick、onChange,在函数组件中通过事件回调驱动状态更新。
一个最小函数组件示例:
import React, { useState } from 'react';
function Counter({ initialCount = 0 }) {
const [count, setCount] = useState(initialCount);
return (
<button onClick={() => setCount((c) => c + 1)}>
Clicked {count} times
</button>
);
}
export default Counter;
3.1 Hooks:useState 与 useEffect
清单的 Hooks 子节 对 Junior 只要求两件事:
- 能使用
useState与useEffect:useState管理局部状态;useEffect承载副作用(订阅、请求、DOM 操作),默认在每次渲染后执行。 - 理解 Hook 的依赖数组(dependency array)如何工作:
useEffect(fn, deps)中的deps数组决定了副作用何时重新执行——依赖项变化时才重新运行;传空数组[]表示只在挂载后运行一次;不传数组则每次渲染都运行。理解它是避免"无限循环请求"和"陈旧闭包"的关键。
import { useEffect, useState } from 'react';
function useDocumentTitle(title) {
useEffect(() => {
document.title = title;
}, [title]); // 仅当 title 变化时重新执行
}
(仓库的 React.md 还包含自定义 Hook、useCallback 的取舍、react-use 库等进阶条目,属于 Regular 阶段的内容。)
四、应用状态管理:Redux 生态入门
状态管理是前端应用中"全局数据流"的核心。Junior 阶段聚焦 Redux 经典生态,对应 Application state management.md 文档。
4.1 Redux 完整流程
你必须能口述并手绘 Redux 单向数据流:
Component --dispatch(action)--> Reducer --返回新state--> Store
^ |
|----------------useSelector 订阅------------------------
- Action:一个带
type字段的普通对象,描述"发生了什么"。 - Reducer:纯函数
(state, action) => newState,根据 action.type 计算新状态,不能直接修改原 state。 - Store:通过
createStore(reducer)创建,持有唯一状态树。
4.2 react-redux:useSelector 与 dispatch
useSelector(selector):从 store 中选取状态切片,React 会自动订阅变化并触发重渲染。Selector 函数接收整个 state 并返回所需部分:const todos = useSelector((state) => state.todos.items);useDispatch():返回 dispatch 函数,在组件中发起 action:const dispatch = useDispatch(); dispatch({ type: 'todos/addTodo', payload: text });
4.3 Redux Toolkit:更高效地创建 reducer 与 action creator
redux-toolkit 是官方推荐的"低样板"工具集,Junior 需要掌握:
- 创建 reducer:用
createSlice同时生成 reducer 与 action creators,内置 immer,可直接"写可变代码"。 - 创建 action creator:slice 自动为每个 reducer 生成同名 action creator,action 的
type字符串可序列化、可被 devtools 追踪。
import { createSlice } from '@reduxjs/toolkit';
const todosSlice = createSlice({
name: 'todos',
initialState: { items: [] },
reducers: {
addTodo(state, action) {
state.items.push(action.payload); // immer 让这里"看起来可变"且安全
},
},
});
export const { addTodo } = todosSlice.actions;
export default todosSlice.reducer;
4.4 不可变数据结构:为什么 Redux 需要它
清单要求你理解在 Redux 应用中不可变数据结构的收益:Reducer 必须返回新引用才能让 React 检测到变化并重渲染;不可变数据让"状态变更历史可回放"(配合 redux-devtools)、避免意外共享引用导致的 bug。同时至少要会用一个提供不可变能力的库——Junior 阶段指定的是 immer:
- 用 immer 创建 reducer:把 reducer 包进
produce,在 draft 上直接修改即可:import produce from 'immer'; const reducer = produce((draft, action) => { switch (action.type) { case 'toggle': draft.done = !draft.done; break; } }, initialState); - 理解 "只修改 state 对象"与"返回修改后的 state 对象"的区别:immer 的 draft 是可变副本,最终由
produce产出不可变的新状态;若直接返回全新对象则跳过 draft 机制。
4.5 Selectors:用 reselect 缓存派生数据
reselect 解决"重复计算派生数据"的问题。createSelector 接收输入选择器与结果函数,只有当输入变化时才重新计算并缓存结果:
import { createSelector } from 'reselect';
const selectItems = (state) => state.todos.items;
const selectDoneCount = createSelector(
[selectItems],
(items) => items.filter((i) => i.done).length
);
4.6 副作用:理解概念并用 redux-saga 处理
- 理解副作用(side effect)概念:任何改变自身作用域之外状态的函数行为——网络请求、写 localStorage、修改 DOM 等。
- redux-saga:用 Generator 函数编排异步流程。Junior 至少掌握:捕获一个副作用,并基于它 dispatch 一个 action(用
take/takeLatest监听 action,用put派发新 action):
import { call, put, takeLatest } from 'redux-saga/effects';
import { fetchTodosApi } from './api';
function* fetchTodos() {
const todos = yield call(fetchTodosApi);
yield put({ type: 'todos/fetchSuccess', payload: todos });
}
export function* todosSaga() {
yield takeLatest('todos/fetchRequest', fetchTodos);
}
(Application state management.md 还包含 select 在 saga 中读状态、eventChannel、actionChannel、redux-saga-routines 等进阶内容,供后续阶段学习。)
五、Apptension React Boilerplate:公司的实战脚手架
清单有一节专门针对 Apptension 自研的 React 模板(基于 create-react-app 生成器,见 Apptension React Boilerplate.md)。Junior 需要掌握四件事:
- 用 create-react-app 的 Apptension React 模板初始化项目:
npx create-react-app my-app --template apptension - 运行 linter:模板内置 eslint/prettier 配置,通过
yarn lint(或 npm 对应脚本)检查并修复代码规范问题。 - 定义一个全新的 Redux 模块(Reducer、Saga、Selector):在
src/modules下新建模块目录,分别导出 reducer、saga、selector,并注册到 store 的combineReducers与 saga 中间件中。仓库 HTTP.md 中引用的 users.sagas.ts 正是这种模块化模式的实例。 - 创建新路由及其组件:在
src/routes下新增路由目录,并在路由配置中注册路径与组件。
Boilerplate 还包含更多工程约定(src/routes 与 src/shared/components 的职责划分、用 plop 生成模块与组件、翻译文件存放位置、extract-intl 脚本提取翻译等),详见 Apptension React Boilerplate.md。
六、样式:从 CSS 基础到 CSS-in-JS 与 Flexbox
6.1 CSS 基础
对应 Styling.md,Junior 需要掌握:
- 写 CSS 规则:选择器、属性、值的基本语法与层叠规则。
- 给元素应用基础样式:颜色(
color/background-color)、尺寸(width/height/padding/margin)、定位(position/top/left)等。 - 正确显示与缩放图片:如使用
aspect-ratio或经典的 padding-top 技巧保持宽高比。 - 水平垂直居中元素:
margin: 0 auto、flex、grid、transform: translate(-50%, -50%)等方法按场景选用。 - 使用媒体查询:
@media (max-width: 768px) { ... }实现响应式布局。
6.2 CSS in JS:styled-components
styled-components 是团队首选的 CSS-in-JS 方案,Junior 需要掌握两个操作:
- 为原始元素创建 styled component:
import styled from 'styled-components'; const Button = styled.button` background: #0066ff; color: white; padding: 8px 16px; border-radius: 4px; `; - 扩展已有组件样式:
const PrimaryButton = styled(Button)` background: #00aa55; `;
(进阶条目还包括全局样式、媒体查询、第三方组件样式覆盖、styled-theming 主题等。)
6.3 Flexbox
Styling 文档推荐了 CSS-Tricks 的 Flexbox 指南(https://css-tricks.com/snippets/css/a-guide-to-flexbox/),Junior 需掌握:
- column 与 row 布局:
flex-direction: row | column决定主轴方向。 - 对齐子元素:
justify-content(主轴)与align-items(交叉轴)。 - 让子元素拉伸至父元素尺寸:默认
align-items: stretch,或显式flex: 1让子元素填充剩余空间。 - 正确使用
flex-basis与flex-wrap:flex-basis定义初始主轴尺寸,flex-wrap控制是否换行:
.container {
display: flex;
flex-wrap: wrap;
gap: 16px;
}
.item {
flex: 1 1 200px; /* grow shrink basis */
}
6.4 UI Kit:至少理解一个组件库
- 清单要求你理解至少一个 UI Kit 库的基础(文档以 material-ui 为例):知道如何安装、如何导入基础组件(Button、TextField、AppBar 等)、如何自定义主题。Styling 文档还列出了 antd 等其他选项,选择哪个取决于团队技术栈与移动端性能诉求。
七、日期与时间:Date 对象
清单在"Date & Time"部分只要求一件事:能为指定日期创建 Date 对象。
// 指定日期:注意月份从 0 开始
const date = new Date(2023, 4, 21); // 2023-05-21
const date2 = new Date('2023-05-21'); // 字符串解析(ISO 格式)
const date3 = new Date(1684627200000); // 时间戳(毫秒)
掌握 Date 对象的构造参数、ISO 字符串解析与时间戳转换,是后续处理时区、格式化(配合 date-fns / dayjs)的基础。
八、路由:react-router 与 react-router-dom
对应 Routing.md 文档,Junior 需要掌握:
- 用
Switch和Route创建简单路由结构:import { BrowserRouter, Switch, Route } from 'react-router-dom'; function App() { return ( <BrowserRouter> <Switch> <Route exact path="/" component={Home} /> <Route path="/users/:id" component={UserDetail} /> <Route component={NotFound} /> </Switch> </BrowserRouter> ); } - 给路由添加参数,并区分必选与可选:
:id是必选参数;可选参数用(/:optional)?语法,或定义多条 Route。 - 精确匹配路由:
exact属性让/只在路径完全匹配时命中,避免与其他路由冲突。 - 渲染 404 页面:在不带
path的<Route>(或path="*")上渲染自定义 404 组件,作为Switch的兜底分支。
8.1 react-router-dom:Link 与 NavLink
Link:声明式导航,渲染为<a>标签并阻止整页刷新:<Link to="/about">About</Link>。NavLink:带激活态的路由链接,命中当前路径时自动添加activeclass,适合导航菜单:
<NavLink to="/about" activeClassName="active">About</NavLink>
(Routing 文档还包含 <Redirect>、浏览器 history 交互、useNavigate/useLocation/useParams/useMatch 路由 Hooks、私有/公开路由拆分与基于权限的安全渲染等进阶能力,这些会逐步出现在 Regular 阶段的要求中。)
九、动画:CSS transitions 与 keyframes
Junior 阶段只要求掌握 CSS 动画(Animations.md):transition 与 keyframes。
/* transition:状态变化时的平滑过渡 */
.button {
background: #eee;
transition: background 0.3s ease;
}
.button:hover {
background: #0066ff;
}
/* keyframes:自定义多阶段动画 */
@keyframes fadeIn {
from { opacity: 0; }
to { opacity: 1; }
}
.banner {
animation: fadeIn 0.5s ease-in-out;
}
(进阶阶段会引入 react-transition-group、framer-motion、gsap、FLIP 技术等,详见 Animations 文档。)
十、国际化:react-intl 组件
清单引用 Internationalization.md,要求"知道并使用 react-intl 组件"。react-intl 是 React 生态最常用的国际化方案:
<FormattedMessage>:在 JSX 中按id渲染翻译文本:import { FormattedMessage } from 'react-intl'; <FormattedMessage id="home.greeting" defaultMessage="Hello" /><FormattedNumber>/<FormattedDate>:按 locale 格式化数字与日期。- 消息定义通常用
defineMessageAPI 组织在*.messages.ts文件中(仓库引用的 home.messages.ts 即这种模式),配合useIntlhook 在代码中取消息。
十一、开发工具:构建、包管理、脚手架与调试
11.1 构建工具:webpack
Junior 只需理解 webpack 的用途与解决的问题(Development Tools.md):它是一个模块打包器,把 JS、CSS、图片、字体等资源按依赖关系打包成浏览器可用的静态文件,解决模块化代码在浏览器中的加载、代码分割、Tree Shaking 与开发热更新等问题。核心概念包括 entry(入口)、output(输出)、loaders(转换器)与 plugins(插件)。
11.2 包管理器:Yarn 与 NPM
- Yarn:掌握内联命令
yarn add <pkg>、yarn install、yarn remove <pkg>;理解 yarn.lock 文件的作用——锁定依赖的精确版本,保证团队与 CI 环境安装结果一致。 - NPM:对应命令为
npm install <pkg>、npm install、npm uninstall <pkg>;理解 package-lock.json 的锁版本作用,与 yarn.lock 同理。
11.3 脚手架:create-react-app
- 能用 CLI 生成新应用:
CRA 封装了 webpack 配置与开发服务器,让初学者专注于业务代码;模板机制(npx create-react-app my-app--template)则让团队能注入自己的约定(如 Apptension 模板)。
11.4 React 相关工具
- prop-types:描述组件的 props 类型,运行时校验,帮助早期发现传参错误:
import PropTypes from 'prop-types'; function Avatar({ src, size }) { /* ... */ } Avatar.propTypes = { src: PropTypes.string.isRequired, size: PropTypes.number, }; - redux-devtools:在浏览器中查看当前 Redux 状态、回放状态变更历史,是调试状态管理的神器。配置后你的 store 才能被 DevTools 检查(详见 Development Tools.md)。
十二、HTTP 请求:fetch 与 axios
12.1 原生 fetch
- 创建 HTTP 请求:
fetch(url, options)返回 Promise:fetch('/api/users', { method: 'GET' }) .then((res) => res.json()) .then((data) => console.log(data));
12.2 Axios
HTTP.md 文档对 axios 列出的能力较多,Junior 阶段的核心条目是:使用 axios 向 API 端点发送 HTTP 请求。仓库引用的 users.sagas.ts 展示了 axios 在 Redux-Saga 中的真实用法。
import axios from 'axios';
const response = await axios.get('/api/users', {
params: { page: 1 },
});
console.log(response.data);
axios 相比 fetch 的优势包括:自动 JSON 转换、请求/响应拦截器、超时配置、取消请求、transformRequest/transformResponse 数据转换、paramsSerializer 序列化参数等——这些进阶条目可在 HTTP 文档中继续学习。
十三、设计协作:Figma
清单要求 Junior 能从设计稿中提取两类信息(Tools.md):
- 提取样式值(geometry 几何、colours 颜色、fonts 字体等):在 Figma 中选中图层,右侧 Inspect 面板可直接复制 CSS 值(字号、行高、色值、圆角、间距等)。
- 提取图片资源:从设计稿中按需要的尺寸导出切图(PNG/WebP/SVG),供前端资源目录使用。
这两项能力让"设计转代码"的衔接更顺畅,是前端日常协作的基本功。(Figma 之外的 Zeplin、Invision、Adobe XD 在文档中也有对应条目。)
十四、如何在仓库中继续深入:文档地图
本文的每个模块都能在仓库中找到更完整的进阶文档,推荐按以下路径深入:
- React 与 Hooks 进阶:Technical Stack/Mobile Developer/React.md
- 状态管理全量清单:Technical Stack/Mobile Developer/Application state management.md
- 样式全量清单:Technical Stack/Frontend%20Developer/Styling.md
- 路由全量清单:Technical Stack/Frontend%20Developer/Routing.md
- 构建与工程工具:Technical Stack/Frontend%20Developer/Development%20Tools.md
- HTTP 与网络层:Technical Stack/Mobile Developer/HTTP.md
- 国际化:Technical Stack/Mobile Developer/Internationalization.md
- 动画:Technical Stack/Frontend%20Developer/Animations.md
- 公司协作实践:Technical Stack/Mobile Developer/Company best practices.md
升级到下一阶段时,可对照 Regular 前端工程师入职清单 与 Junior to Regular 技术指南 制定学习计划。这份清单本身也是开放的——如果你发现某些条目可以补充或修正,可通过 Pull Request 向仓库贡献,技术团队验证后会合入主文档。