WorkBuddy 打开后白屏、点了没反应？先分清是没启动还是没登录
「打不开」是个特别笼统的说法。同样一句话，背后可能是三种完全不同的情况：
- 双击图标什么都没发生，任务管理器里连进程都没有；
- 窗口起来了，但一片空白，什么都不显示；
- 界面正常，点「登录」没反应。
三种的排查方向不一样。先花三十秒分清自己是哪一种，比乱试一小时有用。
本文依据 WorkBuddy 官方常见问题页
From-Beginner-to-Expert-Guide/FAQ与产品页系统要求，核对日 2026-08-16。我们没有安装客户端，本文不含实测数据；官方文档未覆盖的部分会明确标注。
一、三十秒分诊
| 你看到的 | 属于哪一层 | 往哪个方向查 |
|---|---|---|
| 双击图标，屏幕上什么都没出现 | 进程没起来 | 系统要求、安全软件、安装完整性 |
| 窗口出现了但是全白/全灰，没有任何内容 | 进程起来了，渲染没完成 | 显卡驱动、安全软件拦截、重装 |
| 界面正常，点登录没反应 | 程序没问题，是登录链路 | 默认浏览器 → 安全软件 → 目录权限（官方给了三类原因） |
第三种是官方文档覆盖得最完整的，也是最常见的。如果你是第三种，直接跳到第四节。
二、进程都没起来
先确认进程状态。 Windows 按 Ctrl + Shift + Esc 打开任务管理器，在「详细信息」里找 WorkBuddy 相关进程；Mac 打开「活动监视器」搜 WorkBuddy。
如果一个进程都没有，按这个顺序：
第一，核系统版本。 官方产品页标注的要求是 macOS 12.0+、Windows 10+。低于这个版本装了也跑不起来。Windows 按 Win + R 输入 winver；Mac 点左上角苹果图标 →「关于本机」。
第二，看是不是被安全软件干掉了。 官方常见问题页里有一句原话很关键：WorkBuddy 常被误拦截。官方点名的有火绒、360 安全卫士、电脑管家、Windows 安全中心。做法是临时退出安全软件后重试。
这一步值得优先试，因为成本低。有些安全软件拦截的时候不弹提示，直接静默阻止进程启动——表现出来就是「双击了但什么都没发生」，非常迷惑。
第三，看安装包对不对。 Mac 用户尤其要注意：官方分了 .dmg (Intel) 和 .dmg (Apple 芯片) 两个包。装错架构的包，可能表现为启动失败。确认方式是点左上角苹果图标 →「关于本机」看「芯片」那一行。
Windows 用户如果是 ARM 架构的设备（骁龙平台），情况更复杂一些——官方产品页标注 x64 包「兼容 ARM64」，但常见问题页另有一条写「当前版本暂不支持 ARM 64 架构的 Windows 11」。两处口径不一致，这种情况建议直接走反馈路径，别在本机反复折腾。
三、窗口起来了但一片空白
这一类官方常见问题页没有专门的条目，我们不编造原因。能提供的是判断方法和通用处理顺序：
先确认它是真白屏还是在加载。 等 30 秒到 1 分钟。首次启动、刚更新完之后，初始化会慢一些。顺带分清一件事：白屏是窗口还在、内容没渲染出来，如果是窗口整个消失、任务管理器里进程也没了，那属于另一类问题，走 WorkBuddy 崩溃闪退的分诊路径更快。
再试临时退出安全软件。 理由同上——拦截的表现形式不止一种，渲染进程被拦也可能是白屏。
然后试重启客户端。 完全退出（不是关窗口，是任务管理器里确认进程结束），再打开。
还是白屏，收集信息走反馈。 白屏状态下客户端里的反馈入口点不到，但日志文件夹是能找到的：
- Mac：WorkBuddy → 顶部「帮助」→「打开日志文件夹」，里面是日志
.zip包； - Windows：左上角「帮助」下拉框 → 「打开日志目录」，其中的压缩包就是日志。
界面完全不可用的话，官方文档给了支持邮箱 workbuddy@tencent.com，把日志和现象描述一起发过去。
关于日志的一个提醒：官方明确写了，日志仅用于排查问题，但可能包含对话记录、设备信息等数据。发出去之前心里有数，涉及敏感内容的话在描述里说明一下。
四、界面正常，点登录没反应（官方给了三类原因）
这是覆盖最全的一类。官方把它归成三类原因，按排查成本从低到高排：
原因一：没设置默认浏览器（一分钟）
登录要拉起浏览器完成验证。系统里没有默认浏览器，这一步就断了——表现就是「点了完全没反应」。
- Windows：系统设置 → 默认应用 → 把 Chrome 设为默认浏览器 → 然后选择「在浏览器中打开」再次拉起登录验证窗口；或者选择「复制链接」，自己打开浏览器粘贴完成验证。
- Mac：系统偏好设置 → 通用 → 设置默认浏览器为 Chrome 或 Safari → 重启应用重新登录。
「复制链接自己粘贴」这个办法很实用——即使默认浏览器设置有问题，这条路也能绕过去。
原因二：被安全软件拦了（两分钟）
同前面说的，临时退出火绒、360、电脑管家、Windows 安全中心后重试。官方原话就是 WorkBuddy 常被误拦截，关闭安全软件后重试即可。
典型特征是时好时坏，或者装完之后第一次就打不开。
原因三：账号文件夹没有操作权限（五到十分钟）
典型特征是浏览器那边验证走完了，回到客户端还是未登录状态。官方给了两个平台的检查与授权命令，可以直接用。
Mac 检查目录权限：
ls -la ~/Library/Application\ Support/CodeBuddyExtension/
ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/
ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/Public/
ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/Public/auth/
用 whoami 确认当前用户名。如果目录 owner 不是当前用户，授权：
sudo chown -R $(whoami) ~/Library/Application\ Support/CodeBuddyExtension
Windows 检查权限（PowerShell）：
Get-Acl "$env:APPDATA\CodeBuddyExtension" | Format-List
Get-Acl "$env:APPDATA\CodeBuddyExtension\Data" | Format-List
Get-Acl "$env:APPDATA\CodeBuddyExtension\Data\Public" | Format-List
Get-Acl "$env:APPDATA\CodeBuddyExtension\Data\Public\auth" | Format-List
确认 Owner 和 Access 列表里包含当前用户。需要授权的话，用管理员身份打开 PowerShell：
$user = [System.Security.Principal.WindowsIdentity]::GetCurrent().Name
$path = "$env:APPDATA\CodeBuddyExtension"
takeown /F $path /R /D Y
icacls $path /grant "${user}:(OI)(CI)F" /T
然后退出 WorkBuddy 重新打开、重新登录。
这两组命令要注意的是：先跑检查命令看结果，确认确实是权限问题再跑授权命令。授权命令会改目录的所有权和访问控制，不是所有情况都该跑。
五、提工单要带什么
三类都试完还是不行，收集这些一次性提交，能少来回好几轮：
【系统】Windows 11 版本 ____ / macOS ____（winver 或「关于本机」）
【设备架构】x64 / ARM64 / Apple 芯片 / Intel
【安装包】从哪下载的、哪个包
【现象属于哪一层】进程没起 / 白屏 / 登录无反应
【已排除】默认浏览器已设为 ____ ；已临时退出的安全软件：____ ；目录权限检查结果：____
【日志】已从「帮助 → 打开日志文件夹/目录」取到 zip
反馈入口：客户端右上角「帮助」下拉框，或右下角头像 → 设置 - 帮助与反馈 - 意见反馈。描述问题、上传截图，并**勾选「上传日志」**后提交。界面进不去就发邮件到 workbuddy@tencent.com。
小结
- 先分诊三层：进程没起来 / 白屏 / 登录无反应，方向完全不同。
- 进程没起来：核系统版本（macOS 12.0+、Windows 10+）→ 临时退出安全软件 → 确认安装包架构对不对。
- 白屏：官方 FAQ 没有专门条目，按「等一会 → 退安全软件 → 彻底重启 → 取日志走反馈」处理。
- 登录无反应：官方三类原因，按 默认浏览器 → 安全软件 → 目录权限 的顺序排，成本从一分钟到十分钟。
- 官方原话：WorkBuddy 常被误拦截——安全软件这一步别跳过。
- 日志可能包含对话记录与设备信息，提交前心里有数。
功能与命令以官方为准，核对日 2026-08-16。