WorkBuddy 装不上怎么办？官方 FAQ 只覆盖两种情况，其余按这个清单自查
先说个容易让人白折腾半天的事实：WorkBuddy 官方常见问题页里，直接讲「安装失败」的条目只有一条——Windows 11 ARM 64 无法安装。另有一条讲更新时安装目录的处理。除此之外，安装过程本身出问题（双击安装包没反应、装到一半中断、装完找不到程序），官方文档目前没有专门的排查条目。
所以这篇的写法是：先如实告诉你官方覆盖到哪儿，然后给一份靠官方已公开的系统要求、路径、安全软件说明推出来的自查清单。凡是官方没写的，我们标明「官方文档未覆盖」，不编社区偏方。
本文依据 WorkBuddy 官方常见问题页
From-Beginner-to-Expert-Guide/FAQ与国内产品页codebuddy.cn/work/的下载区标注，核对日 2026-08-16。我们没有安装客户端，本文不含实测数据。
一、官方明确覆盖的两条
第一条：Windows 11 ARM 64 无法安装。 官方说明是：当前版本暂不支持 ARM 64 架构的 Windows 11；建议改用受支持的设备环境，或等待后续版本支持。
需要同时说明的是，国内产品页下载区把 Windows 包标注为「x64（兼容 ARM64）」——两处口径不一致。我们并列陈述，不判断哪个对。你如果是骁龙平台的 Windows 设备，这一条跟你有关。
第二条：更新时提示「检测到应用安装目录下存在用户项目目录」。
这是更新场景，不是首次安装。原因是更新或重装时安装目录会清空并重新写入文件，官方给了完整的处理步骤（保留 bin、locales、resources、tools 四个文件夹，其余移走）。
除这两条外，安装过程失败在官方 FAQ 里没有对应条目。 下面是自查清单。
二、第一项：系统版本够不够
官方产品页下载区标注的系统要求：
| 平台 | 要求 |
|---|---|
| macOS | 12.0+ |
| Windows | 10+ |
怎么查：
- Windows：
Win + R→ 输入winver→ 回车，弹窗里能看到版本； - macOS：左上角苹果图标 →「关于本机」。
低于这个版本，安装包可能直接不执行，或者装完启动不了。这一步花十秒，先排掉。
三、第二项：安装包架构对不对
这是 Mac 用户最容易踩的。官方提供的包：
| 平台 | 包 |
|---|---|
| macOS | .dmg (Intel)、.dmg (Apple 芯片) 两个 |
| Windows | Windows x64（兼容 ARM64） 一个 |
Mac 确认自己的芯片：左上角苹果图标 →「关于本机」，看「芯片」那一行——写 Apple M 系列就下 Apple 芯片版，写 Intel Core 就下 Intel 版。
下错包的典型表现：Apple 芯片包在 Intel 机器上根本跑不起来；Intel 包在 Apple 芯片机器上通常能通过系统转译跑，但既然官方分了包，就没必要将就。
Windows 确认自己的架构：Win + R → cmd → 输入 echo %PROCESSOR_ARCHITECTURE%，返回 AMD64 是常规 x64，返回 ARM64 就回到第一节那条。
四、第三项：安全软件（优先级比你想的高）
官方常见问题页里有一句原话值得单独强调：
WorkBuddy 常被误拦截。
官方点名的有：火绒、360 安全卫士、电脑管家、Windows 安全中心。官方给的做法是临时退出后重试。
这句话虽然写在「无法登录」那一节，但安全软件的拦截不会只发生在登录环节。安装阶段被拦的典型表现是：
- 双击安装包，进度条走了一半停住；
- 装完了，但程序文件被隔离，启动时提示找不到文件；
- 完全静默——双击了什么都没发生，也没有任何提示。
最后一种最迷惑人，因为很多安全软件的拦截是不弹窗的。在自查里把「临时退出安全软件重试一次」排在很前面，成本两分钟，命中率不低。
装完之后记得把安全软件开回来。
五、第四项：磁盘空间与安装位置
这一项官方文档没有给最低空间要求，我们不编数字。但有两个跟官方给出的路径直接相关的检查点：
默认安装位置（官方 FAQ 在讲更新时给出）：
| 系统 | 路径 |
|---|---|
| Windows | C:\Users\{用户名}\AppData\Local\Programs\WorkBuddy |
| macOS | /Applications/WorkBuddy.app |
Windows 这个位置在 C 盘的用户目录下。C 盘剩余空间紧张的话，安装或后续更新都可能出问题——更新的机制是清空目录重新写入，中途空间不够就会失败。
检查点一：看 C 盘（Windows）或系统盘（Mac）还有多少空间。 检查点二：确认当前用户对这个路径有写权限。企业统一管理的电脑、域账号环境下，用户目录的权限可能被策略限制。
六、装完之后找不到程序
如果安装过程看着成功了，但开始菜单/启动台里找不到：
- Windows：直接去
C:\Users\{用户名}\AppData\Local\Programs\WorkBuddy看有没有文件。有文件说明装上了，只是快捷方式没建，可以手动建一个。注意AppData是隐藏文件夹，需要在文件资源管理器的「查看」里勾选「隐藏的项目」，或者直接在地址栏粘贴路径。 - macOS：去「应用程序」文件夹（或者路径
/Applications/）找WorkBuddy.app。
顺带说清楚另一个经常被混淆的目录——WorkBuddy 的工作文件不在安装目录里：
| 目录 | 位置 | 装什么 |
|---|---|---|
| 安装目录 | Windows ...\AppData\Local\Programs\WorkBuddy；Mac /Applications/WorkBuddy.app | 程序本体，更新会清空 |
| WorkBuddy 大文件夹 | Windows C:\Users\<用户名>\workbuddy；Mac /Users/用户名/WorkBuddy | 工作空间与历史记录 |
| 账号配置目录 | Windows %APPDATA%\CodeBuddyExtension；Mac ~/Library/Application Support/CodeBuddyExtension | 登录凭证等，权限出问题会导致登录失败 |
第三个目录记住有好处——官方在「无法登录」那一节给的权限检查命令，操作的就是它。
七、还是装不上，提工单带这些
【系统】Windows 11 版本 ____ / macOS ____
【设备架构】x64 / ARM64 / Apple 芯片 / Intel
【下载来源】codebuddy.cn 产品页 /work/ 下载区
【安装包】哪一个包
【失败环节】双击无反应 / 进度中断在 ____ / 装完找不到程序 / 装完启动失败
【已排除】系统版本 ✓ ；包架构 ✓ ；已临时退出的安全软件：____ ；系统盘剩余空间 ____
反馈路径：客户端能打开的话，右上角「帮助」下拉框，或右下角头像 → 设置 - 帮助与反馈 - 意见反馈，描述问题、上传截图并**勾选「上传日志」**提交。客户端打不开就发官方支持邮箱 workbuddy@tencent.com。
日志位置（如果程序至少能启动）：Mac 是顶部「帮助」→「打开日志文件夹」；Windows 是左上角「帮助」下拉框 →「打开日志目录」，里面的压缩包就是日志。官方提示日志可能包含对话记录、设备信息等数据，提交前心里有数。
八、我们不写的东西
- 最低磁盘空间、内存要求——官方页面只写了系统版本，没写这些，不编。
- 静默安装参数、批量部署方式——官方文档未提供。
- 第三方下载站的包——来源不可核，不推荐。
- 「已损坏，无法打开」这类系统级提示的处理——官方 FAQ 没有对应条目，我们不搬社区做法。
- 安装失败的具体错误码含义——官方未列错误码表。
小结
- 官方 FAQ 里跟安装直接相关的只有两条：Windows 11 ARM64 不支持、更新时安装目录的处理。
- 自查四项：系统版本（macOS 12.0+ / Windows 10+）→ 安装包架构（Mac 分 Intel 与 Apple 芯片）→ 临时退出安全软件（官方原话：常被误拦截）→ 系统盘空间与目录写权限。
- 装完找不到程序：Windows 去
AppData\Local\Programs\WorkBuddy，Mac 去/Applications/。 - 三个目录别混：安装目录（更新会清空）、workbuddy 大文件夹（工作空间）、CodeBuddyExtension（账号配置）。
- 官方没写的，我们标注「未覆盖」，不编偏方。
功能与路径以官方为准，核对日 2026-08-16。