Jest 初始化需项目级安装并运行npx jest --init，选jsdom、.test.js后缀和覆盖率；首个测试用expect(1+2).toBe(3)验证；匹配器要按类型选用，mock须在import前声明并清理，异步测试必须正确await或return Promise。
Jest 是目前最主流的 JavaScript 单元测试框架，开箱即用、零配置起步快，但新手常卡在「写完测试却跑不起来」「断言失败但看不出哪错了」「mock 不生效」这几个地方。
如何初始化 Jest 并让第一个测试跑起来
不需要全局安装，项目级依赖更安全。执行命令后 Jest 会自动识别 .test.js 或 .spec.js 文件：
npm init -y npm install --save-dev jest npx jest --init
运行 npx jest --init 时建议：
- 选 Yes 启用 TypeScript 支持（即使当前没用 TS，后续加也方便）
- 选 jsdom 当作测试环境（模拟浏览器 DOM，适合 React/Vue 组件测试）
- 测试文件后缀选 .test.js
- 覆盖率报告选 Yes（后期排查漏测很有用）
生成的 jest.config.js 不用改，直接写一个最简测试就能验证环境：
test('adds 1 + 2 to equal 3', () => {
expect(1 + 2).toBe(3);
});然后运行 npx jest，看到 PASS 就说明基础链路通了。
立即学习“Java免费学习笔记（深入）”；
expect() 的常见匹配器怎么选
expect() 后面接的不是函数调用，而是「断言意图」，选错匹配器会导致报错信息难懂或逻辑误判：
-
toBe()用于严格相等（===），适合数字、字符串、布尔、null、undefined -
toEqual()用于对象/数组深比较，比如expect(obj).toEqual({a: 1}) -
toContain()检查数组是否含某元素，或字符串是否含子串 -
toThrow()验证函数抛出错误，必须传函数引用，不能写fn() -
toBeCalledTimes(n)和toHaveBeenCalledWith(...args)专用于 mock 函数校验
容易踩的坑：
- 用 toBe() 比较对象 → 总是 false，因为引用不同
- 写 expect(fn()).toThrow() → 报错，应写 expect(() => fn()).toThrow()
如何正确 mock 一个模块或函数
mock 的核心目标是「隔离被测代码依赖」，而不是「让测试看起来能过」。常见错误是 mock 位置不对或没还原：
- 模块级 mock 必须放在文件顶部，且在
import之前，否则无效 - 用
jest.mock('./module')自动 mock 整个模块，内部所有导出都变成 mock 函数 - 想只 mock 某个函数，用
jest.fn()替换它，再通过jest.mock('./module', () => ({ func: jest.fn() }))注入 - 测试完记得调用
jest.clearAllMocks()或jest.restoreAllMocks()，避免污染其他测试
例如 mock fetch：
global.fetch = jest.fn();
// 然后在测试中控制返回值：
fetch.mockResolvedValueOnce({ json: () => Promise.resolve({ id: 1 }) });异步测试怎么写才不会超时或漏 await
Jest 默认等待 5 秒，但异步逻辑若没显式处理，会跳过断言直接报 Timeout。三种写法必须对应清楚：
- 返回 Promise：函数末尾
return fetch(...).then(...)，Jest 自动等待 - 使用
async/await：函数声明加async，内部await所有异步操作 - 回调形式：函数参数加
done，并在异步完成时调用done()（少用，易忘）
错误示范：test('fetches data', () => { await fetch('/api'); expect(...); }) → 语法错误，必须加 asynctest('fetches data', async () => { fetch('/api'); expect(...); }) → 没 await，断言在请求发出前就执行了
真实项目里最难的不是写测试，而是判断「该不该测」「测到什么粒度」——比如工具函数必须全覆盖，但组件渲染逻辑往往更适合集成测试；mock 过细会让测试脆弱，过粗又失去隔离意义。这些边界得结合具体代码慢慢试出来。
