打开项目与仓库克隆——本地项目和 GitHub 代码库

打开本地项目

打开本地项目文件夹是最常用的方式：

1. 启动 Qoder IDE，在欢迎页点击「打开」；或使用快捷键。
2. 在文件浏览器中浏览到项目根目录，选择即可。
3. 左侧文件树会自动加载项目结构。

项目目录要求

• Qoder IDE 会对整个打开的目录建立索引，理解代码库结构。
• 建议直接打开项目的 根目录（包含 package.json、pom.xml、go.mod 等的目录），不要打开子目录。
• 如果项目很大，索引可能需要一些时间——状态栏会显示进度。

从 GitHub 克隆代码库

方式一：URL 克隆

1. 在欢迎页点击「Clone repo」。
2. 顶部搜索栏输入仓库 URL（如 https://github.com/user/repo.git）。
3. 点击「Clone from URL」。
4. 选择本地保存位置，等待克隆完成。

方式二：GitHub 账号克隆

1. 点击「Clone from GitHub」。
2. 在浏览器中授权 Qoder IDE 访问你的 GitHub 仓库列表。
3. 在 Qoder IDE 中浏览你的仓库，选择要克隆的。

多项目工作

Qoder IDE 支持同时打开多个项目：

• 通过菜单栏的「文件 → 添加文件夹到工作区」可以把多个目录加入当前工作区。
• 每个文件夹在左侧文件树中独立显示。
• Agent 可以理解整个工作区的代码结构。

项目索引

打开项目后，Qoder IDE 会自动建立代码索引：

• 索引过程中，Agent 的代码搜索和理解能力可能不完整。
• 索引完成后，状态栏会显示就绪。
• 索引会持续增量更新——你修改或新增文件后，索引自动更新。

索引状态检查

可以在设置里查看索引进度和范围，也可以手动触发重新索引（比如项目目录结构变化较大时）。

目录排除规则

某些目录你可能不希望 Qoder 索引：

• node_modules/、vendor/、dist/ 等构建产物和依赖目录默认被排除。
• 可以在设置中自定义排除规则。
• Agent 找不到文件或找错目录时，先检查排除规则是否过宽——详见 Agent 找错目录排查。

下一步

• 打开项目后开始编码 → Editor 编码视图
• 项目打开了但索引还没就绪 → 等待索引完成或检查排除规则