🎬 本节视频教程
下载好安装包后，这一节我们分平台详细讲解安装步骤。无论你用 Windows 还是 Mac，跟着做，几分钟就能装好。
一、Windows 安装指南#
安装步骤#
- 找到安装包：在"下载"文件夹找到
WorkBuddySetup.exe - 双击运行：如果弹出"用户账户控制"提示，点击"是"允许
- 跟随安装向导：
- 安装向导启动后，会提示"选择安装用户"，建议选择"仅为我安装"
- 选择安装位置（默认即可，也可自定义）
- 点击"安装"开始
- 完成安装：进度条走完后点击"完成"
Windows 默认目录#
安装完成后，相关文件位置：
| 内容 | 默认路径 |
|---|---|
| 程序安装目录 | C:\Users\<用户名>\AppData\Local\Programs\WorkBuddy |
| 工作区目录 | C:\Users\<用户名>\workbuddy |
| 扩展数据 | $env:APPDATA\CodeBuddyExtension |
Windows 安装常见问题#
问题1：安装被安全软件拦截
- 临时关闭火绒、360、电脑管家、Windows 安全中心等
- 或将安装包加入信任白名单
- 安装完成后可重新开启安全软件
问题2：提示"权限被拒绝"
- 对
CodeBuddyExtension目录及其子文件夹，当前用户需有"完全控制"权限 - 右键文件夹 → 属性 → 安全 → 编辑权限
问题3：安装后无法启动
- 以管理员身份运行
- 检查系统是否为 Windows 10/11 x64
- 查看是否有其他安全软件持续拦截
二、macOS 安装指南#
安装步骤#
- 找到安装包：在"下载"文件夹找到
WorkBuddy.dmg - 双击打开：弹出安装窗口，左侧是 WorkBuddy 图标，右侧是 Applications 文件夹
- 拖动安装：把 WorkBuddy 图标拖入 Applications 文件夹
- 等待拷贝：进度条完成后，推出（Eject）dmg 镜像
- 启动应用：
- 在启动台（Launchpad）找到 WorkBuddy，或用
Cmd + Space搜索"WorkBuddy" - 首次启动可能提示"无法打开"或"来自身份不明的开发者"
- 在启动台（Launchpad）找到 WorkBuddy，或用
- 放行（如需要）：前往
系统设置 → 隐私与安全性，点击"仍要打开"放行
macOS 默认目录#
| 内容 | 默认路径 |
|---|---|
| 应用程序 | /Applications/WorkBuddy.app |
| 工作区目录 | /Users/<用户名>/WorkBuddy |
macOS 安装常见问题#
问题1："无法打开，因为无法验证开发者"
- 这是 macOS 的安全机制（Gatekeeper）
- 解决：
系统设置 → 隐私与安全性→ 滚动到下方 → 点击"仍要打开"
问题2：提示"已损坏，无法打开"
- 多为下载不完整或系统缓存问题
- 重新下载安装包
- 或在"终端"执行：
xattr -cr /Applications/WorkBuddy.app（清除隔离属性）
问题3：拖入 Applications 时提示需要密码
- 输入你的 Mac 登录密码即可，这是正常的权限确认
三、升级与重装#
如何升级#
WorkBuddy 支持在线自动更新：
- 点击左下角账号头像 → 进入"个人中心"
- 点击**"检查更新"**
- 有新版本时按提示升级
也可以从官网重新下载最新版覆盖安装。
重装注意事项#
重要：重装会清空安装目录并覆盖文件。重装前务必：
- 把个人文件、项目从安装目录（
bin/locales/resources/tools等子目录）移出 - 工作区目录（
workbuddy或WorkBuddy）一般不受影响，但建议也备份重要内容 - 记录你的登录方式和已配置的连接器/技能，方便重装后恢复
四、安装后的首次启动#
无论哪个平台，安装完成后首次启动 WorkBuddy：
- 会弹出登录页面（下一节详解）
- 可能需要授权文件夹访问权限（首次使用时提示）
- macOS 用户还需在系统设置中授权"辅助功能""屏幕录制"等权限（详见 2.4 节）
小结#
这一节我们完成了 WorkBuddy 的安装。关键要点：
- Windows：双击 exe → 选"仅为我安装" → 完成
- macOS：打开 dmg → 拖入 Applications → 首次启动到"隐私与安全性"放行
- 重装前务必把个人文件移出安装目录
装好后，下一节我们来完成登录和工作区配置。