文件与编辑
打开工作区、添加项目、资源树右键、保存与忽略规则。
文件与编辑
本章说明在开发系统里如何管理项目文件。更完整的工作区概念见 工作区与文件。
打开与切换工作区
| 入口 | 操作 |
|---|---|
| 场景控制台 | 打开工作区 / 切换工作区 |
| 菜单 | 文件 → 打开文件夹...（快捷键 Ctrl+K Ctrl+O） |
| 资源空态 | 打开工作区… |
| 命令面板 | Ctrl+Shift+P / Cmd+Shift+P，搜索工作区相关命令 |
打开文件：Ctrl+O。新建文件：Ctrl+N。
打开后检查：路径是否正确、资源 能否展开、终端目录是否一致。首页 最近工作区 可快速回到用过的项目；不需要的项可从列表移除（不删磁盘）。
打开文件夹会替换当前工作区。 要同时看两个仓库，用下面的「添加项目」，不要再点一次「打开文件夹」。
多根工作区（添加项目）
一个任务涉及多个目录时（例如前端 + 后端）：
- 先打开第一个目录。
- 资源树点 添加项目（+），或菜单 文件 → 项目 → 添加项目...，或在树空白处右键 添加项目。
- 文件树出现多个根后，右键某个根可：设为当前项目、从文件树隐藏/显示、置顶、在新窗口中打开、从列表移除。
「当前项目」会影响：资源树焦点、终端工作目录、Git、审核列表、AI 写入的根目录。提问时用 @ 引用不同根下的路径，不要只靠口头描述「另一个仓库在某某盘」。
从列表移除只拿掉工作区条目，不会删除磁盘文件。确认原文：「仅从项目列表移除，不会删除磁盘上的文件。确定继续？」
资源树常用操作
| 操作 | 做法 |
|---|---|
| 打开文件 | 单击或双击文件名 |
| 新建文件 / 文件夹 | 在目标目录右键，或空白处右键；行内输入名称 |
| 重命名 | 选中后 F2，或右键重命名；弹窗说明「输入新名称（含扩展名）」 |
| 删除 | 右键删除或 Delete；确认「确定要删除 xxx 吗？」 |
| 移动 | 拖到目标目录 |
| 复制 / 剪切 / 粘贴 | 右键；粘贴仅对文件夹 |
| 复制路径 | 右键：复制相对路径 / 复制绝对路径 |
| 在终端中打开 | 右键文件夹 |
| 在文件管理器中显示 | 右键 |
| 添加到对话 | 右键：添加到对话 / 添加到新对话 |
| 刷新 / 折叠所有 | 右键或工具栏刷新 |
改名、删除前确认没有未保存内容，也没有被终端进程占用。删除不可从本软件「回收站」恢复，以操作系统为准。
行尾可能有 Git 色点，悬停可见：已修改 / 已添加 / 已删除 / 未跟踪 / 已忽略 / 冲突。有变更时，文件右键还可：暂存更改、取消暂存、还原更改、查看历史。还原会确认：「确定丢弃对「xxx」的更改吗？」
保存
- 编辑后立即保存，避免只改了编辑器、磁盘仍是旧内容。
- 文件 → 保存 / 另存为... / 全部保存。
- 设置 → 文件：可开自动保存（延迟后保存，或失去焦点时保存）。
- 关闭带脏标记的标签时，按提示选择保存或放弃。
Agent 改了选区但尚未保存时，界面可能提示请用 Ctrl+S 保存到文件。
给 AI 指定文件
AI 答偏时，优先补上下文，而不是先换模型：
- 先打开相关文件再提问。
- 选中一段代码再问（解释、审查局部）。快捷键
Ctrl+Alt+I可把选区 添加到 AI 对话。 - 输入
@选择路径，明确「只看这个文件」或「只改这个文件」。 - 把终端报错贴进对话，或终端右键 添加到对话。
- 资源树右键文件 添加到对话。
忽略无关目录
大项目请尽快排除构建产物、依赖目录、缓存和大型生成文件。好处是文件树更干净、搜索更快、AI 更少读到无关内容。
可以改的入口：
- 设置 → 文件 → 排除文件（常见默认含
node_modules、.git、dist、build） - 监视器排除（常见默认含
**/.git/**、**/node_modules/**） - Git 文件右键 添加到 .gitignore（规则已存在会提示已在文件中）
- 工作区搜索里的包含 / 排除 glob
排除只影响搜索和监视，不会从磁盘删除。被 Git 忽略的文件仍可能出现在树里，色点显示「已忽略」。