> 先说结论：**升级 ≠ 搬家。想换盘，我这次走的是卸载重装。**
>
> 说明一下：本文记录的是我 2026-09-14 在 Windows 上的实际经历，涉及版本 5.3.14 → 5.5.6。文中凡是"现象"都是我真实遇到的；凡是"原因"属于我的推断，我都会标明是推断，不确定的地方我会直接说不确定。

## 一、起因

C 盘越来越满，加上一直有个执念——把工具都挪出系统盘，重装系统时能不丢。于是决定把 WorkBuddy 从默认安装位置搬到 D 盘。

原以为点几下「检查更新」就完事，结果来回折腾了挺久。这篇把过程和踩到的坑记下来，谁要搬，照着走能少走弯路。

## 二、先摸清底细

WorkBuddy 是 Electron 桌面端，默认按用户安装，我这台机器上的实际位置是：

```
C:\Users\<用户名>\AppData\Local\Programs\WorkBuddy
```

不是 `Program Files`，所以在 Windows 的「应用和功能」里按名字搜可能搜不到，得直接看安装目录。

当前版本号可以从安装目录里的这个文件读到：

```
<安装目录>\resources\install-manifest.json
```

里面的 `appVersion` 就是版本。我搬之前读到的是 `5.3.14`，重装后是 `5.5.6`。

**我实测到的情况**：点客户端的「检查更新」只会原地覆盖升级，整个过程里没有出现"选择安装位置"的步骤。所以想换盘，我的做法是卸载重装：

| 你想干的事 | 我这次用的做法 |
|---|---|
| 升级版本 | 客户端左下角头像 → 检查更新 |
| 换盘 / 换目录 | 卸载后重新安装，在安装向导里改路径 |

## 三、搬家的正确流程（5 步）

⚠️ **动手前必读**：所有用户数据——对话记忆、自定义技能、模型配置、各种连接器授权——都在这个目录里：

```
C:\Users\<用户名>\.workbuddy\
```

它**和程序安装目录是分开的**。清理时千万别删它，否则新版启动后就是一张白纸。

### 第 1 步：备份

PowerShell 或 CMD 里执行（把用户名换成你自己的）：

```bat
xcopy "C:\Users\你的用户名\.workbuddy" "D:\backup\workbuddy" /E /H /K /Y
```

保险起见，整个文件夹再复制一份到移动硬盘也行。

### 第 2 步：完全退出 WorkBuddy

窗口点 ✕ 是不够的——**托盘图标也要右键退出**。安装器要覆盖 `WorkBuddy.exe`，文件被进程占用时，安装可能失败或者装出半成品。

### 第 3 步：卸载

运行安装目录里的 `Uninstall WorkBuddy.exe`。如果向导里出现涉及删除数据的选项，**一律不要勾**；不确定的话，先确认第 1 步的备份已经做完再往下走。

### 第 4 步：运行新安装包

从官网下载最新安装包，运行，在向导里把安装路径改掉。我用的是纯英文路径（原因见下面的坑 3）。

### 第 5 步：启动验证

打开新版，按第五节的清单逐项核对。

## 四、我踩到的 5 个坑

下表每一条都是我这次实际遇到的。右列的"原因"里，凡是我自己推断出来的，都会标注。

| # | 现象 | 原因 | 我怎么解的 |
|---|---|---|---|
| 1 | 桌面/开始菜单图标变成"白纸" | 旧快捷方式还指向已删除的旧路径（这条我验证过） | 删掉旧图标，去新目录右键 exe 重建 |
| 2 | 搬完后命令行基础工具失效 | 有实测线索，但没有官方结论（见坑 2） | 完全退出重启 + 临时补 PATH |
| 3 | 处理中文路径的脚本报错 | 某个 Python 库对非 ASCII 路径的编码处理有 bug | 目录名改用英文 |
| 4 | 文件删了但磁盘空间没释放 | 删除走的是回收站，这是 Windows 的通用机制 | 清空回收站 |
| 5 | 用户数据可能被误删 | 数据目录与程序目录分离，删掉不可逆 | 只能靠备份回滚 |

### 坑 1：图标变成白纸

搬完之后，桌面和开始菜单里的 WorkBuddy 图标变成了一个白纸样子，看着像程序坏了。

**这条原因我验证过**：安装器卸载时没有清理旧的快捷方式，那个 `.lnk` 文件里写的目标路径还是老地址：

```
C:\Users\<用户名>\AppData\Local\Programs\WorkBuddy\WorkBuddy.exe
```

这个目录已经不存在了 —— 快捷方式指着空气，图标自然就白了。

**解法（15 秒）**：

1. 把旧的白纸图标直接删掉（它指向的文件已经没了，删了没有损失）
2. 打开新的安装目录，右键 `WorkBuddy.exe` → **发送到 → 桌面快捷方式**
3. 想固定到任务栏/开始屏幕：同样右键 exe → 固定到任务栏
4. 开始菜单里那个坏条目在这里：`Win + R` 输入 `shell:programs` 回车，删掉里面的 `WorkBuddy.lnk`

**一个小细节**：删完图标如果还显示白纸，是 Windows 的图标缓存没刷新，桌面按 `F5` 或注销重登一次即可。

### 坑 2：命令行基础工具失效

搬完之后我发现：`ls`、`grep`、`head` 这类基础命令全报 `command not found`，连删除文件都静默失败。

**我事后翻到的线索**：命令的搜索路径是在**进程启动那一刻**拼装好的。我这次的日志里能看到，启动脚本在拼 `PATH` 的时候有一行报错（`dirname: command not found`），之后的目录注入跟着断了。

需要说明的是：**这只是我在自己这台机器上看到的线索，我没有官方结论**，也不能确定它是不是唯一原因。所以下面给的是按现象处理的办法。

**我用的解法**：先把 WorkBuddy 完全退出（窗口 ✕ 不够，托盘图标也要右键退出），再重新打开一次。如果还是不行，就手动补一下路径临时绕过（前提是你知道工具目录在哪）：

```bash
export PATH="/你的工具目录/usr/bin:/c/Windows/System32:/c/Windows:$PATH"
```

### 坑 3：中文路径引发的脚本报错

我图好玩，把安装目录起成了带中文的名字。程序本体能正常跑，但我在处理快捷方式时踩了一次：**一个 Python 库在写中文路径的 `.lnk` 文件时把路径写坏了**——它对非 ASCII 路径的编码处理有 bug。

不是每个人都会撞上，但**结论很清楚：目录名用纯英文 + 数字更省事。**

### 坑 4：删了文件，空间没回来

卸载后残留的安装包（我这边 500MB 出头）删掉之后，D 盘剩余空间一点没变。

因为删除走的是回收站，文件还在 `$Recycle.Bin` 里躺着。想真释放空间，得清空回收站。好处是删错了能捞回来，坏处是别以为删完就腾出空间了。

### 坑 5：用户数据只有一次机会

这个坑我没踩（提前备份了），但风险是实打实的：**用户数据目录和程序目录是分开的**，一旦在卸载或清理的时候手滑删掉，记忆、技能、授权全没，而且不可逆。

唯一的安全网就是第 1 步的备份。**别跳过备份。**

## 五、搬完之后的验证清单

搬完打开新版，逐项核对：

- 客户端左下角头像里显示的版本号是新版本
- 用户数据目录还在，且里面文件的时间戳是旧的（说明没被覆盖）
- 之前的对话记忆、自定义技能还在
- 连接器/授权状态正常（不需要重新登录）
- 旧安装目录已经不存在
- 桌面/任务栏快捷方式双击能正常启动

## 六、值不值得搬？

最后说句实话：**如果你的目的只是"升级"，那别折腾，点「检查更新」就行。**

搬盘能带来的实际收益只有两个：

1. 给 C 盘腾出几个 G 的空间（其实程序本体不大，真正占地方的是使用过程中产生的文件和缓存）
2. 重装系统时不用重装 WorkBuddy

如果你的 C 盘没到告急的程度，为这两点折腾挺久不太划算。真要做，就在**备份**和**退出进程**这两步上多花点心思——剩下的坑都能爬出来。


说明一下：本文记录的是我 2026-09-14 在 Windows 上的实际经历，涉及版本 5.3.14 → 5.5.6。文中凡是"现象"都是我真实遇到的；凡是"原因"属于我的推断，我都会标明是推断，不确定的地方我会直接说不确定。

#WorkBuddy# 从 C 盘搬到 D 盘实录：5.3.14 → 5.5.6，我踩过的 5 个坑

客户端

职业发展

开发工具

WorkBuddy从C盘迁移至D盘全攻略：实测5.3.14→5.5.6版本，详细记录卸载重装流程、5个常见坑及解决方案（白纸图标、命令失效、中文路径报错等），附完整备份验证清单，避免数据丢失风险。

代码解释

WorkBuddy 

Windows

Python

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

#WorkBuddy# 从 C 盘搬到 D 盘实录：5.3.14 → 5.5.6，我踩过的 5 个坑-腾讯云开发者社区-腾讯云

#WorkBuddy# 从 C 盘搬到 D 盘实录：5.3.14 → 5.5.6，我踩过的 5 个坑

#WorkBuddy# 从 C 盘搬到 D 盘实录：5.3.14 → 5.5.6，我踩过的 5 个坑

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐