我们只写能在界面上复现的步骤。凡是无法验证的说法,宁可不写。

本站编辑 · 技术文档方向

我们写什么,不写什么

我们写什么,不写什么

内容范围

本站聚焦 WhatsApp 网页版的登录与日常使用:扫码流程、浏览器环境要求、多设备同步行为、常见报错排查、安全设置。每篇文档都按「现象、判断依据、操作步骤、预期结果」组织,目标是让读者照着做就能得到明确结论。

写作原则

  • 只描述界面上可观察到的行为,不推测内部实现
  • 涉及时间与数量时标注「通常」「一般」,不伪造精确数据
  • 不推荐任何非官方客户端或自动化工具
  • 不编造客户案例、奖项或统计数字

更新方式

界面与菜单文字会随版本变化。我们会在发现明显差异时修订对应段落,并在页面中保留对版本差异的说明,而不是假装所有版本完全一致。若你发现某段描述与当前界面不符,可通过下方邮箱反馈具体页面与现象。

与官方的关系

本站是独立的技术说明文档,与 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 秒左右自动刷新一次,手动刷新页面可强制生成新码);在浏览器隐私模式下登录导致每次关闭窗口后需重新配对;多设备同时登录时误以为消息不同步(实际为各设备独立接收,已读状态在多数情况下会同步)。每条错误会注明触发条件、可观测现象和规避方式,不涉及任何绕过官方限制的手段。

文档类型典型内容验证方式常规更新频率
登录与配对二维码扫描、手机号配对、多设备管理双人界面走查界面变更后 48 小时内
消息与同步已读回执、历史消息加载、通知行为网络请求核对每季度复核一次
隐私与安全端到端加密说明、已屏蔽联系人、登录设备列表对照官方帮助页与实测每半年复核一次
故障排查二维码不显示、通知无声音、消息延迟复现步骤记录按反馈触发更新

表中「常规更新频率」指无重大界面改动时的复核周期;若期间收到可复现的读者反馈,会提前进入复核流程。所有复核均不改变文档结构,只修正与当前版本不符的描述。

反馈与联系

发现描述与界面不符,或想补充某类故障的排查方法,可以写信说明具体页面、浏览器版本与现象。

反馈时附上页面路径与复现步骤,能显著加快核对速度。我们不提供账号找回或登录代办服务。