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 就说明基础链路通了。
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 位置不对或没还原：
家电公司网站源码是一个以米拓为核心进行开发的家电商城网站模板，程序采用metinfo5.3.9 UTF8进行编码，软件包含完整栏目与数据。安装方法：解压上传到空间，访问域名进行安装，安装好后，到后台-安全与效率-数据备份还原，恢复好数据后到设置-基本信息和外观-电脑把网站名称什么的改为自己的即可。默认后台账号：admin 密码：132456注意：如本地测试中127.0.0.1无法正常使用，请换成l
- 模块级 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 过细会让测试脆弱，过粗又失去隔离意义。这些边界得结合具体代码慢慢试出来。
