Developer Handbook:初级前端工程师(Junior Frontend Developer)技能清单与实践指南

原创2026-10-09 13:57:551,743 阅读
文章标签:文档教程

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 协作习惯:

  1. 创建命名与描述规范的 Pull Request:PR 标题应一句话概括改动意图,描述区说明"为什么改、怎么改、如何验证",让评审者不需要猜测上下文。
  2. Squash Merge 你的 PR:将开发过程中的多次提交合并为一条语义清晰的提交,保持主干历史线性、可读。团队文档中还强调理解 git rebase 与 git merge 的取舍(Company best practices.md 中有完整条目)。
  3. 规范命名提交信息:例如遵循 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 文档的核心条目):

  1. 写函数组件:函数组件是接收 props 并返回 JSX 的纯函数,是当前 React 的主流写法。
  2. 区分函数组件与类组件:函数组件无 this 绑定、无自己的生命周期方法(由 Hooks 替代),类组件需要 extends React.Component 并实现 render()。
  3. 定义与修改组件局部状态:函数组件用 useState,类组件用 this.state + this.setState()。
  4. 理解 Virtual DOM 及 React 的渲染机制:React 在内存中维护一棵虚拟 DOM 树,状态或 props 变化时先计算差异(diff),再批量更新真实 DOM,从而提升渲染性能。
  5. 使用元素事件并融入生命周期:例如 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 需要掌握四件事:

  1. 用 create-react-app 的 Apptension React 模板初始化项目:
    npx create-react-app my-app --template apptension
    
  2. 运行 linter:模板内置 eslint/prettier 配置,通过 yarn lint(或 npm 对应脚本)检查并修复代码规范问题。
  3. 定义一个全新的 Redux 模块(Reducer、Saga、Selector):在 src/modules 下新建模块目录,分别导出 reducer、saga、selector,并注册到 store 的 combineReducers 与 saga 中间件中。仓库 HTTP.md 中引用的 users.sagas.ts 正是这种模块化模式的实例。
  4. 创建新路由及其组件:在 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:带激活态的路由链接,命中当前路径时自动添加 active class,适合导航菜单:
<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 格式化数字与日期。
  • 消息定义通常用 defineMessage API 组织在 *.messages.ts 文件中(仓库引用的 home.messages.ts 即这种模式),配合 useIntl hook 在代码中取消息。

十一、开发工具:构建、包管理、脚手架与调试

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 生成新应用:
    npx create-react-app my-app
    
    CRA 封装了 webpack 配置与开发服务器,让初学者专注于业务代码;模板机制(--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):

  1. 提取样式值(geometry 几何、colours 颜色、fonts 字体等):在 Figma 中选中图层,右侧 Inspect 面板可直接复制 CSS 值(字号、行高、色值、圆角、间距等)。
  2. 提取图片资源:从设计稿中按需要的尺寸导出切图(PNG/WebP/SVG),供前端资源目录使用。

这两项能力让"设计转代码"的衔接更顺畅,是前端日常协作的基本功。(Figma 之外的 Zeplin、Invision、Adobe XD 在文档中也有对应条目。)


十四、如何在仓库中继续深入:文档地图

本文的每个模块都能在仓库中找到更完整的进阶文档,推荐按以下路径深入:

升级到下一阶段时,可对照 Regular 前端工程师入职清单 与 Junior to Regular 技术指南 制定学习计划。这份清单本身也是开放的——如果你发现某些条目可以补充或修正,可通过 Pull Request 向仓库贡献,技术团队验证后会合入主文档。

登录后查看全文
developer-handbook