WorkBuddy 更新失败提示「安装目录下存在用户项目目录」？官方给了完整处理步骤
点了检查更新，弹出来一句：
检测到应用安装目录下存在用户项目目录
然后更新就停在这儿了。这个提示看着像警告，其实是保护机制——它在告诉你：我马上要清空这个目录重写文件了，你有东西在里面，先拿走。
官方文档给了完整的处理步骤，照做就行。但更值得花两分钟搞明白的是为什么会出现这个情况，因为这背后有个使用习惯上的坑。
本文依据 WorkBuddy 官方常见问题页
From-Beginner-to-Expert-Guide/FAQ，核对日 2026-08-16。我们没有安装客户端，路径与界面文案以官方文档和你实际看到的版本为准。
一、为什么会有这个提示
官方给的原因很简单：更新或重装时，安装目录会清空并重新写入文件。
也就是说，更新不是「往里面覆盖几个新文件」，而是「把这个目录清干净，再把新版本铺进去」。如果你的任务文件、生成的文档、工作目录恰好在这个安装目录里面，清空的时候就一起没了。
所以它先停下来问你。这个提示出现是好事——它拦住了一次可能的数据丢失。
二、官方给的处理步骤
第一步：找到安装目录
在 WorkBuddy 图标上右键 →「打开文件所在位置」。
官方文档给的常见安装目录：
| 系统 | 路径 |
|---|---|
| Windows | C:\Users\{用户名}\AppData\Local\Programs\WorkBuddy |
| macOS | /Applications/WorkBuddy.app |
第二步：认出哪些是程序文件夹
官方说明，安装目录下通常有这几个文件夹：
bin
locales
resources
tools
_
第三步：移除对话产生的文件夹，只保留四个
官方原话的口径是：移除对话产生的文件夹，仅保留 bin、locales、resources、tools。
也就是说，除了这四个之外，你在这个目录里看到的其他东西——以日期命名的文件夹、你自己起名的项目文件夹、生成的文档——都是要移走的。
第四步：检查有没有个人文件，一并移走
官方专门强调了这一步：检查是否有个人文件并一并移走，防止被覆盖。
移到哪儿？移到一个跟安装目录完全无关的地方，比如 D:\WorkBuddy工作区\，或者用户目录下你自己建的文件夹。别移到桌面——后面会说为什么。
第五步：重新打开客户端，走更新
重新打开客户端，点上方 WorkBuddy → 检查更新，等待安装包下载完成。
三、动手之前，先做一件官方没写但成本极低的事
把整个安装目录复制一份到别处。
理由很直接：第三步要你「移除对话产生的文件夹」，判断哪些是「对话产生的」得靠你自己看。万一你把某个其实是程序需要的东西删了，或者反过来漏掉了一个重要的工作文件，有备份就是几分钟的事，没备份可能就找不回来了。
复制一份的成本是几十秒和一点磁盘空间。这跟官方在别处反复强调的那句是一个道理——成熟用法不是期待永不出错，而是提前准备好回退方案。
四、根子上的问题：工作目录不该建在安装目录里
处理完这一次，更值得改的是习惯。
WorkBuddy 有个「工作空间」的概念——当前任务主要读写文件的那个文件夹。你创建任务时选的文件夹，或者它自动建的任务文件夹，就是工作空间。
工作空间不该落在安装目录里。 原因就是这篇讲的：安装目录会被更新清空。
官方在权限模式相关文档里给的建议是，每类任务建独立文件夹，还给了四个命名示例：
weekly-report
invoice-archive
customer-data-cleanup
batch-image-processing
把这些文件夹放在一个专门的位置——比如 D:\WorkBuddy\ 下面，或者用户文档目录下——就再也不会撞上更新清空这件事。
顺便说一下另一个更常见的位置错误：别把工作空间建在桌面。桌面看着方便，但它是个特殊目录，跟系统、跟其他软件都有牵连；官方常见问题页里有一条专门讲「整理桌面后出现文件丢失」的高风险场景，把作业范围直接放桌面是在给自己找麻烦。
五、还有一类「更新之后东西不见了」
跟这个提示相关但不是同一件事，顺带说清楚：官方 FAQ 里另有一条——升级或隔天重启后，原工作空间文件夹在界面里消失。
- 现象：升级重启后原有工作空间在界面中不见了；部分用户能在
C:\Users\<用户名>\workbuddy找到历史文件夹但有文件缺失，也有用户整个目录都找不到。 - 官方做法：打开文件管理器（Windows）或 Finder（Mac），找到 WorkBuddy 的大文件夹——Windows 是
C:\Users\<用户名>\workbuddy，Mac 是/Users/用户名/WorkBuddy；通过 WorkBuddy 打开以日期或自定义名字命名的文件夹，即可找回原有历史记录。 - 官方建议：将重要文件同步保存到独立目录。
注意这里有两个不同的路径，别搞混：
| 目录 | 位置 | 性质 |
|---|---|---|
| 安装目录 | Windows ...\AppData\Local\Programs\WorkBuddy；Mac /Applications/WorkBuddy.app | 程序文件，更新会清空 |
| WorkBuddy 大文件夹 | Windows C:\Users\<用户名>\workbuddy；Mac /Users/用户名/WorkBuddy | 工作空间与历史记录所在 |
「界面里工作空间不见了」的时候，去后面这个路径找；「更新提示安装目录里有用户项目」的时候，处理的是前面那个。
六、什么情况下这篇解决不了
诚实标一下边界：
- 更新包下载失败、卡在下载进度——这不是本文这个提示，属于网络或服务端问题，官方 FAQ 未给专门条目。
- 更新后功能异常、版本号没变——官方文档没有对应说明，走反馈路径。
- 移走的文件夹怎么重新导入回工作空间——官方 FAQ 另有一条提到「工作文件夹无法导入（拖拽无效）」，并且明确写了当前文档未提供明确修复方案。遇到这种情况，官方给的是记录系统版本、拖拽方式与报错现象后提交排查。
最后这条是个二级确定性的典型：官方承认现象存在，但没给修复方案。我们照实说，不编社区偏方。
小结
- 提示的原因：更新会清空安装目录并重写文件，你有东西在里面。
- 找安装目录：图标右键 →「打开文件所在位置」。Windows
C:\Users\{用户名}\AppData\Local\Programs\WorkBuddy；macOS/Applications/WorkBuddy.app。 - 仅保留
bin、locales、resources、tools，其余对话产生的文件夹与个人文件一并移走。 - 动手前先把整个安装目录复制一份，成本几十秒。
- 重新打开客户端 → 上方 WorkBuddy → 检查更新。
- 根治办法：工作空间别建在安装目录里，也别建在桌面，单独找个位置按任务分文件夹。
- 「界面里工作空间不见了」是另一件事，去
C:\Users\<用户名>\workbuddy（Mac/Users/用户名/WorkBuddy）找。
功能与路径以官方为准，核对日 2026-08-16。