mock微信sdk是为了在非微信环境模拟其行为以提升开发测试效率，需覆盖核心api、按环境自动加载、支持单元测试精准控制，并保留真实接口参数结构与错误码格式。
在开发微信公众号、小程序或企业微信应用时，本地调试常受限于微信 SDK 的环境依赖（如必须在微信内置浏览器中运行 wx.config），无法直接调用真实接口。Mock 微信 SDK 不是为了绕过安全机制，而是为了在非微信环境（如 Chrome 浏览器、单元测试、CI 环境）中模拟其行为，保障开发与测试效率。
一、Mock 核心 API：覆盖常用方法和回调逻辑
微信 JS-SDK 提供的接口（如 wx.chooseImage、wx.getLocation、wx.openLocation）大多为异步调用，带 success / fail / complete 回调。Mock 时需保留这一调用模式，并按需返回模拟数据。
- 全局挂载
window.wx对象，补全常用属性（如wx.ready、wx.error、wx.checkJsApi） - 每个方法内部用
setTimeout模拟异步延迟，避免同步执行导致测试断言失败 - 支持传入配置项控制返回结果（例如让
wx.getLocation有时成功、有时失败，便于测试异常流程）
示例（简易 Mock）：
window.wx = {
config: () => {},
ready: (cb) => setTimeout(cb, 0),
error: (cb) => {},
checkJsApi: ({ jsApiList, success }) => {
success({ checkResult: Object.fromEntries(jsApiList.map(api => [api, true])) });
},
getLocation: ({ success, fail }) => {
setTimeout(() => Math.random() > 0.2
? success({ latitude: 39.904, longitude: 116.407 })
: fail({ errMsg: 'getLocation:fail' }), 0);
}
};
二、按环境自动加载：开发/测试时启用 Mock
避免 Mock 代码污染生产环境，推荐通过环境变量或 UA 特征动态判断是否启用。
让 AI 读懂微信公众号。自研 7 阶段提取管道，穿透反爬率 99.89%，Token 消耗降低 50%–87%。支持 ChatGPT、Claude、Perplexity、Gemini 等平台无缝引用。
- 检测是否在微信浏览器外运行：
!/MicroMessenger/i.test(navigator.userAgent) - 结合 Webpack DefinePlugin 或 Vite define，注入
import.meta.env.DEV && import.meta.env.VITE_MOCK_WECHAT === 'true' - 在入口文件（如
main.js）中条件加载 Mock 脚本，或在测试 setup 文件中统一注入
三、单元测试中精准控制：用 Jest/Vitest 替换模块
若项目使用模块化引入（如 import { wx } from '@/utils/wx-sdk'），更推荐在测试中 mock 整个模块，而非污染全局 window.wx。
- Jest 中使用
jest.mock('@/utils/wx-sdk', () => ({ wx: mockWx })) - Vitest 中用
vi.mock('@/utils/wx-sdk', async (importOriginal) => {...}) - 对每个方法返回
vi.fn()，方便后续expect(wx.getLocation).toHaveBeenCalled()断言 - 可借助
vi.mocked类型推导，保持 TypeScript 类型安全
四、进阶：Mock 签名与 config 验证逻辑
真实场景中，wx.config 需要后端提供签名（jsapi_ticket + URL），而本地开发常无签名服务。此时可 Mock 签名验证环节：
- 重写
wx.config，跳过签名校验，直接触发wx.ready - 或模拟一个“宽松签名”函数：只要
nonceStr和timestamp存在，就认为签名有效 - 注意：Mock 仅用于前端开发/测试，上线前务必关闭，且服务端签名逻辑不可省略
不复杂但容易忽略的是——Mock 后仍需保留原始接口的参数结构和错误码格式（如 fail: { errMsg: 'xxx:fail' }），否则业务层的错误处理逻辑可能失效。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
