我们只写能在界面上复现的步骤。凡是无法验证的说法,宁可不写。
本站编辑 · 技术文档方向
我们写什么,不写什么

内容范围
本站聚焦 WhatsApp 网页版的登录与日常使用:扫码流程、浏览器环境要求、多设备同步行为、常见报错排查、安全设置。每篇文档都按「现象、判断依据、操作步骤、预期结果」组织,目标是让读者照着做就能得到明确结论。
写作原则
- 只描述界面上可观察到的行为,不推测内部实现
- 涉及时间与数量时标注「通常」「一般」,不伪造精确数据
- 不推荐任何非官方客户端或自动化工具
- 不编造客户案例、奖项或统计数字
更新方式
界面与菜单文字会随版本变化。我们会在发现明显差异时修订对应段落,并在页面中保留对版本差异的说明,而不是假装所有版本完全一致。若你发现某段描述与当前界面不符,可通过下方邮箱反馈具体页面与现象。
与官方的关系
本站是独立的技术说明文档,与 WhatsApp 及其母公司无隶属关系,也不代表官方立场。涉及账号、隐私与商业接口的权威信息,请以官方帮助中心与官方文档为准。
文档维护节奏
- 每月
核对登录流程页
检查扫码步骤与菜单文字是否与当前界面一致。
- 每季度
复核兼容性说明
根据主流浏览器版本变化调整支持情况描述。
- 收到反馈后
修订对应段落
按读者反馈的具体页面与现象定位并更新。

每篇文档在发布前会经过三个阶段的验证,确保所述内容与当前线上版本一致。第一阶段是界面走查:编辑使用桌面浏览器(Chrome 120+、Firefox 121+、Edge 120+)访问 web.whatsapp.com,按文档步骤逐项操作,记录每个按钮的文案、位置和触发条件。第二阶段是机制核对:对于涉及同步、通知、二维码刷新等机制描述,对照浏览器开发者工具中的网络请求与 WebSocket 行为,确认描述与实测一致。第三阶段是交叉复核:由另一位编辑在独立设备上重复走查,若两次结果不一致,该段落标记为待核实,暂不发布。
文档头部会标注版本标记,格式为「验证版本:v2.2402.xx」,其中数字对应 WhatsApp Web 构建号,可在页面「设置 → 帮助 → 关于」中查看。构建号每周通常更新 1 到 2 次,但界面改动频率较低,因此文档版本号与构建号并非一一对应。当构建号变更且界面出现可观测差异时,我们会在 48 小时内更新受影响的段落,并在文末变更记录中注明修改点。
界面描述的最小粒度约定
为避免歧义,文档对界面元素的描述遵循最小粒度约定:按钮名称用引号标注原文,例如「链接设备」;菜单路径用箭头连接,例如「设置 → 隐私 → 已屏蔽联系人」;输入框与开关分别用「输入框」「开关」指代,不使用「选项」「设置项」等模糊词。对于随语言环境变化的文案,文档以简体中文界面为基准,并在括号中给出英文原文,例如「链接设备(Link with phone number)」,方便切换语言的用户对照。
常见操作错误的记录方式
文档会单独列出高频错误,而不是混在正常步骤中。目前记录在案的高频错误包括:二维码过期后未刷新页面而反复扫描(二维码通常每 20 秒左右自动刷新一次,手动刷新页面可强制生成新码);在浏览器隐私模式下登录导致每次关闭窗口后需重新配对;多设备同时登录时误以为消息不同步(实际为各设备独立接收,已读状态在多数情况下会同步)。每条错误会注明触发条件、可观测现象和规避方式,不涉及任何绕过官方限制的手段。
反馈与联系
发现描述与界面不符,或想补充某类故障的排查方法,可以写信说明具体页面、浏览器版本与现象。
反馈时附上页面路径与复现步骤,能显著加快核对速度。我们不提供账号找回或登录代办服务。