别让提示说废话：vibe 项目的上下文帮助与气泡提示实战

气泡提示最常见的死法，是它出现的时候用户并不需要它，或者需要的时候它说了一句废话。“点击这里提交表单”贴在提交按钮旁边，就是一句废话；“提交后我们会在一个工作日内把结果发到你的邮箱，期间不需要重复提交”贴在同一个地方，就是有用的信息。差别不在位置，而在信息：提示只应该解释“为什么”，不应该重复标签本身已经说清楚的事。

本文所有示例均为虚构，包括“松果记账”“青禾小店”等产品名、人物和文案例子，都是为了讲清楚做法编出来的，不要当成真实产品案例去引用。

什么信息值得放进提示：只解释“为什么”

判断一条信息该不该进气泡提示，有一个简单的筛子：用户如果不知道这件事，会不会填错、选错，或者不敢点下一步？会，就值得放；不会，就别放。标签本身已经说清楚的事不要重复。按钮写着“保存”，提示就不要写“点击保存你的修改”。用户需要的是标签没说的那半句：保存之后会发生什么、这个选项会带来什么后果、这个数字是怎么算出来的。

值得放进提示的有四类。第一类是后果：选了这个选项会发生什么，尤其是不可逆或者要等很久的后果，比如“开启后，过去的账单不会重新计算，只影响之后的新账单”。第二类是口径：数字、状态、等级是怎么定义的，比如“活跃用户指过去三十天内至少登录过一次的账号”。第三类是格式与来源：这个字段要填什么格式、从哪里能找到，比如“订单号在确认邮件的右上角，是一串十位数字”。第四类是例外：大多数情况下成立、但有少数情况不同的规则，比如“周末的提现顺延到周一处理”。

不值得放的有三类。一是操作说明本身：如果按钮的用途还需要提示来解释，说明按钮文案或布局本身有问题，先修按钮，别用提示打补丁。二是营销话术：提示不是广告位，“升级高级版解锁更多功能”贴在免费功能旁边，只会让用户觉得被推销。三是法律条文全文：提示里放一句话摘要加一个“查看完整条款”链接就够了，把几百字条款塞进气泡里，没人会读完，读完了也记不住。

虚构示例：松果记账的“自动分类”开关旁边，最初的提示写的是“开启自动分类功能”。用户还是不知道开不开，因为他想问的是“开了之后，我以前手动分的账会不会被改掉”。改成“开启后只影响之后的新账单，以前手动分的账不会动”，问题就消失了。好提示回答的是用户心里那个没说出口的问题，而不是把开关名字复述一遍。

触发方式怎么选：桌面有悬停，手机没有

触发方式不是审美选择，是设备现实。桌面端有鼠标悬停，移动端没有；键盘用户用聚焦，触屏用户用点击和长按。每种触发方式都有它的适用场景和代价，选错了，提示要么打扰人，要么根本出不来。

悬停适合桌面端的轻量补充：用户把鼠标停在一个小问号图标上，提示出现，鼠标移开就消失。它的代价是“发现难”：用户不知道哪里可以悬停，就会错过。补救办法是给可悬停的元素一个统一的视觉标记，比如始终可见的小问号图标，而不是让用户去猜哪段文字可以悬停。悬停提示不能承载关键信息，因为触屏用户和键盘用户根本触发不了它；关键信息必须同时出现在别的地方，比如字段下方的常驻小字。

点击触发是最通用的选择，尤其适合移动端：点一下问号图标，提示以气泡或底部弹窗出现，再点一下或点空白处关闭。它的代价是多一次点击，所以只适合用户确实会主动寻求帮助的地方。不要把所有字段都配上点击提示，那会把界面变成满屏问号。只在筛子筛出来的四类信息上放点击提示，其他地方宁可留空。

聚焦触发是为键盘用户准备的：用 Tab 键走到某个字段或图标时，提示出现，焦点离开时消失。很多团队只做了悬停和点击，忘了聚焦，结果键盘用户永远看不到提示。实现时要把提示的触发元素做成可聚焦的，提示本身不要抢焦点，否则键盘用户的 Tab 顺序会被打乱。

长按在移动端是一个备选，但要慎用。长按的发现率很低，而且容易和系统自带的长按菜单、文本选择冲突。如果用了长按，必须同时提供点击入口作为替代，不能只靠长按。还有一个容易踩的坑：把提示做成“鼠标悬停才出现、触屏上完全没有”，等于直接放弃了一半用户。移动端没有悬停，这是铁律，任何只在悬停里出现的信息，在移动端都必须有点击或常驻文字的替代。

提示文案三行原则：第一句给答案，后面再给理由

提示文案要按三行来写。第一行给答案，直接回答用户的问题，不铺垫、不寒暄。第二行给理由或后果，只在用户需要判断时才写。第三行给去处，只在用户可能需要更多帮助时才写，比如“详细规则见帮助中心《提现时间说明》”。三行是上限，不是目标：能一行说清的，绝不写三行。

对照一下好坏。坏文案：“该功能用于设置您的偏好，以便系统更好地为您服务。”这句话说了等于没说，用户读完还是不知道开不开。好文案：“开启后，新账单会自动按商家归类；以前手动分的账不会动。”第一句是答案，第二句是后果，没有第三句，因为不需要去处。再比如坏文案：“请输入有效的手机号码。”这是报错，不是提示。好文案：“我们只用这个号码给你发验证码，不会用来打推销电话。”它回答的是用户真正担心的事：这个号码会不会被滥用。

文案还有三个硬规矩。一是说人话，不用术语：写“钱到账要等一天”，不要写“结算周期为 T+1”。二是不要用“可能”“也许”含糊其辞：不确定的规则先去跟后端或业务确认，确认不了就写清楚边界，“周末顺延”比“一般情况下较快”有用得多。三是数字要具体：写“一个工作日内”，不要写“尽快”；写“过去三十天”，不要写“最近一段时间”。含糊的提示比没有提示更糟，因为它给了用户一种“我已经知道了”的错觉。

提示文案要随产品一起测试：找三个没见过这个功能的人，让他们读提示，然后问他们“你现在知道该怎么选了吗”。如果三个人里有两个还要追问，文案就没写到位。文案不是写给产品经理看的，是写给第一次见这个功能的用户看的。

频率控制：第一次要出现，第十次就别再烦人

提示的出现频率，比提示的内容更容易惹恼用户。同一个提示，用户第一次见是帮助，第十次见是骚扰。频率控制要分三种情况：首次出现、重复出现、常驻提示。

首次出现要主动一点，但只主动一次。新功能上线、用户第一次走到某个复杂字段时，提示可以自动出现一次，帮用户迈过第一道坎。但自动出现必须能一眼关掉，关闭按钮要大、要显眼，不要做成需要找半天的小叉。自动出现的提示一次只出现一个，不要同时弹三个气泡，用户会被吓跑。

重复出现要克制。用户已经看过、关掉过的提示，不要在他每次回到这个页面时都重新弹出来。记录用户“已看过”或“已关闭”的状态，下次默认收起，只保留问号图标等用户主动点开。有一个例外：如果规则变了，提示内容变了，可以再主动出现一次，但要标明“规则有变化”，让用户知道这次值得再看一眼。

常驻提示是另一种思路：不依赖气泡，把关键信息直接写成字段下方的灰色小字，永远可见。适合那种“每次填都要提醒”的信息，比如“提现金额需为十的倍数”。常驻小字的代价是占用空间，所以只给真正高频、真正容易错的信息用。低频信息用气泡，高频易错信息用常驻小字，两者不要混着用，更不要同一条信息既做气泡又做常驻小字，用户会觉得你在重复唠叨。

频率控制还要考虑“用户已经学会了”的信号：如果用户连续几次都没有点开某个提示、也没有在该字段出错，说明他已经学会了，系统可以把这个提示降级为仅图标。但降级是系统行为，不要悄悄删掉用户主动找帮助的入口：问号图标一直都在，点开一直都有内容。

与帮助中心、新手引导的分工：三者各管一摊

上下文帮助、帮助中心、新手引导是三件不同的工具，混着用就会互相抢戏。分工可以一句话说清：气泡提示解决“这一处我不懂”，帮助中心解决“我要系统地搞明白一件事”，新手引导解决“我第一次来，不知道先干什么”。

气泡提示管的是当下、具体、短小的问题，长度以三行为上限，回答的是眼前这个字段、这个开关、这个数字。超过三行还说不清的，就不要硬塞进气泡，改成一句话加一个链接，把用户送到帮助中心对应的文章里。链接的文字要写明去向，比如“查看提现时间完整规则”，不要只写“了解更多”，用户点之前应该知道自己会去哪里。

帮助中心管的是成体系的知识：规则、流程、政策、常见问题合集。气泡提示不应该复述帮助中心文章的第一段，而应该只给结论加链接。反过来，帮助中心文章里也不应该贴满气泡提示的截图，那是把两种工具的职责弄反了。两者的衔接点就是链接：气泡给结论，链接给全文，中间不要断。

新手引导管的是第一次使用的顺序：先做什么、再做什么、做完能得到什么。它讲的是路径，不是知识点。气泡提示不应该承担新手引导的职责：不要在每个字段旁边都放一个“新手小贴士”气泡，试图把引导拆成十几个气泡发出去。用户第一次来的时候，给他一条清晰的引导路径；等他开始自己操作了，气泡提示再在具体卡点上出现。顺序不能反：先路径，后知识点。

三者分工的检验方法是：把一篇帮助中心文章、一轮新手引导、十条气泡提示摆在一起，看有没有内容重复超过一半。如果气泡提示和帮助中心文章在说同一段话，说明气泡太长了；如果新手引导的每一步都在解释字段含义，说明引导越位了。重复超过一半的，就砍掉其中一处。

无障碍：键盘能走到，屏幕阅读器能读到

气泡提示的无障碍不是加分项，是底线。键盘用户必须能用 Tab 键走到触发元素，按回车或空格打开提示，按 Esc 关闭提示，关闭后焦点回到触发元素上。如果提示一打开就把焦点吸走、关掉后焦点不知道去了哪里，键盘用户就会迷路。测试时拔掉鼠标，只用键盘走一遍所有带提示的页面，走不通就是不合格。

屏幕阅读器用户需要两件事：第一，触发元素要有可读的文本标签，比如“关于自动分类的说明”，而不是一个只有问号图标、读出来是“按钮”的元素；第二，提示出现时，屏幕阅读器要能读到提示内容。做法是把提示内容放进无障碍树里关联到触发元素，或者让提示出现时用 polite 级别的播报通知用户，不要用 aggressive 级别打断用户正在听的内容。提示关闭后不要留下读不出来的残留文本。

还有几个容易被忽略的点：提示不能只靠颜色传达信息，比如不要只用红色气泡表示警告，还要有文字说明“注意”；提示的对比度要达标，浅灰字放在浅色气泡上，视力弱的用户根本读不了；提示出现和消失不要用闪烁或快速缩放的动画，容易诱发不适的用户要能关掉动效。无障碍测试不需要昂贵的设备：键盘走一遍、屏幕阅读器听一遍、把系统调成大字体和高对比模式看一遍，这三遍走完，大部分问题就现形了。

深色模式与小屏适配：提示不能只在浅色大屏上好看

提示最容易在深色模式里翻车：浅色模式下好看的淡黄气泡，到了深色模式可能变成刺眼的亮块，或者文字和背景糊成一团。规矩是：气泡背景、文字、边框、阴影都要有深色模式的对应值，不能只换页面背景、不换气泡。深色模式下的气泡背景要比页面背景稍亮或稍暗，形成层次，但对比度不能过高，纯白气泡贴在纯黑页面上会晃眼。阴影在深色模式下基本失效，要靠边框和亮度差来区分层次。

小屏适配的规矩更具体：气泡宽度不能超过屏幕宽度减去两边边距；靠近屏幕边缘的触发元素，气泡要自动换方向，不要被屏幕裁掉一半；长提示在小屏上要改成底部弹窗，而不是硬挤成一个细长的气泡。底部弹窗在小屏上的好处是：宽度够、手指够得着关闭按钮、不会被键盘顶出屏幕。判断标准很简单：在最小的常用手机宽度上，把所有带提示的元素点一遍，气泡没有被裁、没有挡住正在输入的字段、关闭按钮点得到，就算过关。

深色模式和小屏都要进提测清单，而不是上线后等用户反馈。提测前做一张表：浅色桌面、深色桌面、浅色移动、深色移动，四种组合各截一张带提示的图，图里要有最长的那条提示。最长的提示在四种组合下都完整可读，这篇的适配才算过关。

一份提示文案自查清单

每条提示上线前逐项打勾。信息筛查：这条提示回答的是用户心里没说出口的问题，而不是复述标签；它属于后果、口径、格式来源、例外四类之一；不是操作说明、营销话术或法律全文。触发方式：桌面有悬停时移动端有点击或常驻文字替代；关键信息不只放在悬停里；键盘聚焦能触发，Esc 能关闭，关闭后焦点回到触发元素。

文案：第一句就是答案，能一行说清绝不写三行；没有术语，没有“可能”“尽快”这类含糊词，数字具体；三个没见过功能的人读完后都知道该怎么选。频率：首次只主动出现一次且能一眼关掉；关闭过的提示下次默认收起，只留图标；规则变了再主动出现时标明了变化；高频易错信息用了常驻小字而不是反复弹气泡。

分工：超过三行说不清的已改成一句话加帮助中心链接，链接文字写明去向；没有复述帮助中心文章，也没有替新手引导讲路径。无障碍与适配：只用键盘走得通；屏幕阅读器读得到触发元素和提示内容；提示不只靠颜色传达信息；深色模式下背景、文字、边框都有对应值；最小手机宽度上气泡不被裁、不挡输入框、关闭按钮点得到。

最后提醒一句：提示的终极检验不是它写得有多漂亮，而是它出现之后，用户在那个字段的出错率有没有降下来。上一条提示，跑一周数据，看该字段的错误率和客服咨询量有没有变化。没有变化的提示，要么是信息选错了，要么是触发方式错了，要么是文案没说到点子上——总有一个地方错了，数据会告诉你是哪个。