AgentHarness 课程
CodeBuddy 专题/第 1 章

CodeBuddy IDE 基础与界面熟悉

安装配置、界面布局、第一个项目

引言：为什么选择 CodeBuddy IDE？

在 AI 辅助开发的浪潮中，开发者面临一个核心问题：如何让 AI 真正融入开发工作流，而不只是一个聊天窗口？

传统的开发流程是：打开 IDE → 写代码 → 遇到问题 → 切换到浏览器搜索 → 回来继续写。CodeBuddy IDE 彻底改变了这个模式——它将 AI 能力深度集成到 IDE 的每一个角落，让你在编码的同时获得智能辅助，无需切换上下文。

本章将带你从零开始熟悉 CodeBuddy IDE 的安装、配置和基础使用，为后续的高级功能打下坚实基础。

1. 安装与配置详解

1.1 系统要求

平台最低要求推荐配置
macOS10.15+，4GB RAM，2GB 磁盘空间macOS 13+，8GB RAM，SSD
WindowsWindows 10+，4GB RAM，.NET 4.7.2Windows 11，8GB RAM，SSD
LinuxUbuntu 20.04+ / Debian 10+，4GB RAMUbuntu 22.04+，8GB RAM，SSD

提示：CodeBuddy IDE 基于 Electron 构建，内存占用较高。建议至少 8GB RAM 以获得流畅体验。

1.2 安装步骤

macOS 安装：

# 方式一：官网下载
# 访问 https://www.codebuddy.cn/download 下载 .dmg 文件
# 双击安装，拖入 Applications 文件夹

# 方式二：Homebrew 安装
brew install --cask codebuddy

Windows 安装：

# 方式一：官网下载 .exe 安装包
# 方式二：winget 安装
winget install CodeBuddy.CodeBuddy

Linux 安装：

# Ubuntu/Debian
wget https://www.codebuddy.cn/download/linux -O codebuddy.deb
sudo dpkg -i codebuddy.deb

# 或使用 AppImage
chmod +x CodeBuddy-*.AppImage
./CodeBuddy-*.AppImage

1.3 首次配置向导

安装完成后首次启动，CodeBuddy 会引导你完成基础配置：

  1. 登录账号：支持手机号、微信、GitHub 登录
  2. 选择主题：暗色 / 亮色 / 跟随系统
  3. 导入设置：从 VS Code 导入快捷键和扩展配置
  4. 选择 AI 模型：默认使用推荐模型，可后续切换
  5. 关联 Git：自动检测已有的 Git 配置

2. 界面布局详解

CodeBuddy IDE 的界面分为五个核心区域，每个区域都深度集成了 AI 能力：

+-----------------------------------------------------+
|                   顶部导航栏                          |
+--------+------------------------+-------------------+
|        |                        |                   |
|  左侧  |     中央编辑区          |   右侧 AI 面板    |
|  文件树 |                        |                   |
|        |                        |                   |
+--------+------------------------+-------------------+
|                    底部终端                           |
+-----------------------------------------------------+

2.1 顶部导航栏

顶部导航栏是项目级操作的入口：

元素功能说明
项目名称当前项目标识点击可切换项目
AI 对话入口核心交互区域全局搜索 + AI 对话
部署按钮一键部署连接 CloudBase / EdgeOne
分支切换Git 分支管理可视化分支操作
设置图标偏好设置模型选择、快捷键、主题

2.2 左侧文件树

文件树展示项目结构，但增加了 AI 增强功能：

  • AI 标记：AI 生成或修改过的文件会有特殊图标
  • 右键菜单增强：
    • CodeBuddy: 解释此文件 — AI 分析文件内容
    • CodeBuddy: 重构此文件 — AI 优化代码结构
    • CodeBuddy: 生成测试 — 为文件创建单元测试
  • 智能排序：最近编辑的文件自动置顶

2.3 中央编辑区

代码编辑区是核心工作区域，集成了多项 AI 能力：

  • 实时代码补全：灰色建议文本，按 Tab 接受
  • 内联对话：选中代码后按快捷键直接对话
  • 错误诊断：红色/黄色波浪线 + 灯泡图标修复建议
  • 代码透镜：函数上方显示引用数、类型信息
  • 差异对比：AI 修改后实时显示变更高亮

2.4 右侧 AI 面板

右侧面板是 AI 交互的主阵地：

标签页功能
对话与 AI 的完整对话历史
任务AI 拆解的任务步骤和状态
检查点代码版本快照列表
文件引用当前上下文中引用的文件

2.5 底部终端

集成终端支持 AI 直接执行命令：

# AI 可以直接在终端执行操作
$ npm install express     # AI 安装依赖
$ git status              # AI 查看 Git 状态
$ pytest tests/           # AI 运行测试

终端输出会被 AI 实时读取，用于判断执行结果和后续决策。

3. 快捷键完整参考

3.1 AI 核心快捷键

操作macOSWindows/Linux说明
打开 AI 对话Cmd+KCtrl+K打开全局 AI 对话框
内联对话Cmd+ICtrl+I在代码编辑区直接对话
接受补全TabTab接受 AI 补全建议
拒绝补全EscapeEscape关闭补全建议
触发补全Ctrl+SpaceCtrl+Space手动触发代码补全
逐词接受Cmd+RightCtrl+Right逐词接受补全建议

3.2 编辑快捷键

操作macOSWindows/Linux
命令面板Cmd+Shift+PCtrl+Shift+P
快速打开文件Cmd+PCtrl+P
全局搜索Cmd+Shift+FCtrl+Shift+F
格式化代码Shift+Option+FShift+Alt+F
代码折叠Cmd+Option+[Ctrl+Alt+[
代码展开Cmd+Option+]Ctrl+Alt+]

3.3 导航快捷键

操作macOSWindows/Linux
跳转到定义F12F12
查看引用Shift+F12Shift+F12
切换标签页Cmd+Shift+[Ctrl+Shift+[
关闭当前标签Cmd+WCtrl+W

4. 项目模板对比

CodeBuddy 内置多种项目模板，帮助你快速启动不同类型的项目：

模板技术栈适用场景AI 增强
Web 应用React / Vue / Next.js前端 SPA自动生成路由和组件
API 服务Express / FastAPI / Go后端接口自动生成 CRUD 和文档
全栈应用Next.js + Supabase前后端一体全栈代码生成
小程序原生 / Taro / uni-app微信小程序组件模板和页面
移动应用React Native / FlutteriOS / Android跨平台组件
静态站点Astro / Hugo / VitePress文档/博客Markdown 处理
CLI 工具Node.js / Go / Rust命令行工具参数解析和帮助文档

模板选择建议

需要快速原型？  -> Web 应用（React）
需要后端服务？  -> API 服务（FastAPI）
需要全栈项目？  -> 全栈应用（Next.js + Supabase）
需要小程序？    -> 小程序（Taro）

5. 第一个项目实战

让我们通过一个完整的实战来熟悉 CodeBuddy IDE 的核心功能。

5.1 目标

创建一个任务管理应用（Todo App），包含以下功能：

  • 添加/删除/完成任务
  • 任务分类和过滤
  • 数据持久化

5.2 步骤一：创建项目

  1. 点击 文件 -> 新建项目
  2. 选择 Web 应用 模板
  3. 技术栈选择 React + TypeScript
  4. 项目名称：todo-app

5.3 步骤二：与 AI 对话

在 AI 对话框输入：

创建一个任务管理应用，要求：
1. 用户可以添加新任务
2. 任务可以标记为完成/未完成
3. 支持按状态过滤（全部/进行中/已完成）
4. 使用 localStorage 持久化数据
5. 界面简洁美观，使用 Tailwind CSS

5.4 步骤三：观察 AI 工作

CodeBuddy 会自动执行以下步骤：

  1. 分析项目结构：读取 package.json、tsconfig.json 等配置
  2. 创建文件： 
    src/
+-- components/
|   +-- TodoInput.tsx      # 输入组件
|   +-- TodoItem.tsx       # 单个任务组件
|   +-- TodoList.tsx       # 任务列表组件
|   +-- TodoFilter.tsx     # 过滤组件
+-- hooks/
|   +-- useLocalStorage.ts # 本地存储 Hook
+-- types/
|   +-- todo.ts            # 类型定义
+-- App.tsx                # 主组件
  3. 安装依赖：自动运行 npm install
  4. 启动开发服务器：自动执行 npm run dev

5.5 步骤四：迭代优化

AI 完成初版后，继续用自然语言优化：

添加以下功能：
1. 双击任务可以编辑
2. 添加任务计数器（显示剩余未完成数量）
3. 添加"清除已完成"按钮

5.6 步骤五：使用检查点

如果对某次修改不满意：

  1. 点击右侧面板的 检查点 标签
  2. 查看历史版本列表
  3. 点击 回退 恢复到之前的版本

6. 常见陷阱与解决方案

陷阱 1：首次打开项目索引缓慢

现象：大项目首次打开时，代码补全不可用

原因：CodeBuddy 需要索引项目文件以理解上下文

解决：

  • 等待右下角索引进度完成
  • 大项目（10万+ 行）索引可能需要 2-5 分钟
  • 可在设置中排除不需要索引的目录（如 node_modules）

陷阱 2：AI 生成的配置文件被手动修改

现象：手动修改 AI 生成的 tsconfig.json 或 .eslintrc 后，AI 功能异常

原因：AI 依赖这些配置来理解项目规范

解决：如果需要修改配置，通过 AI 对话告知修改原因，让 AI 同步更新

陷阱 3：IDE 和插件设置不同步

现象：在 VS Code 插件中配置的 Rules 在 IDE 中不生效

原因：IDE 和插件的设置是独立的

解决：使用项目级配置文件（.codebuddy/rules/），这样 IDE 和插件都能读取

陷阱 4：内存占用过高

现象：IDE 运行一段时间后变得卡顿

解决：

  • 定期关闭不需要的标签页
  • 在设置中限制同时打开的文件数
  • 重启 IDE 释放内存

总结

本章我们完成了 CodeBuddy IDE 的基础学习：

学习内容掌握程度
安装与配置三平台安装 + 首次配置
界面布局五大区域功能详解
快捷键AI / 编辑 / 导航三大类
项目模板七种模板对比选择
第一个项目从创建到迭代的完整流程

下一章预告：我们将深入学习 CodeBuddy 的智能体模式，了解 AI 如何从被动回答升级为主动执行复杂任务。

FAQ

Q: CodeBuddy IDE 和 VS Code + CodeBuddy 插件有什么区别？

A: IDE 版本集成了更多深度功能（如一键部署、检查点可视化），而插件版本适合已经在使用 VS Code 的团队。两者共享核心 AI 能力。

Q: 离线环境下能使用 CodeBuddy 吗？

A: 代码编辑和基础功能可以离线使用，但 AI 功能需要网络连接。部分模型支持本地部署，详见企业版文档。

Q: 如何切换 AI 模型？

A: 点击右上角设置图标 -> AI 设置 -> 模型选择。不同模型在速度和能力上有差异，简单任务建议使用轻量模型。

Q: CodeBuddy 支持哪些编程语言？

A: 支持所有主流编程语言，包括 JavaScript/TypeScript、Python、Java、Go、Rust、C/C++ 等。对 TypeScript 和 Python 的支持最为完善。