 指南)
在 DevEco Studio 中查看 Git 本地更改 (Local Changes) 指南
概述
本文档介绍如何在鸿蒙应用开发工具 DevEco Studio 中查看和管理 Git 的本地更改 (Local Changes)，包括打开版本控制工具窗口、查看文件状态以及常见问题解决方法。
1. 打开版本控制工具窗口
1.1 通过菜单栏打开
- 在 DevEco Studio 顶部菜单栏中，点击“View (查看)”
- 选择“Tool Windows (工具窗口)”
- 点击“Version Control (版本控制)”
1.2 通过快捷方式打开
- Windows/Linux: 使用快捷键
Alt + 9 - macOS: 使用快捷键
⌘ + 9
2. 查看本地更改
2.1 Local Changes 选项卡
- 打开 Version Control 工具窗口后，在左侧面板中找到并点击“Local Changes”选项卡
- 该区域将显示所有已修改、新建或删除的文件，按修改状态分组
2.2 文件状态说明
| 状态 | 颜色/图标 | 说明 |
|---|---|---|
| 已修改 | 蓝色 | 文件内容有更改 |
| 新建 | 绿色 | 项目中新增的文件 |
| 已删除 | 红色 | 从项目中删除的文件 |
| 冲突 | 红色闪烁 | 文件存在合并冲突 |
2.3 查看具体更改内容
- 在 Local Changes 列表中，点击任意文件
- 右侧将显示差异对比窗口，其中：
- 绿色背景行表示新增内容
- 红色背景行表示删除内容
- 行号旁有标记指示具体更改位置
3. 项目文件树中的状态提示
除了 Version Control 窗口，你还可以直接在项目文件树中查看文件状态：
- 修改状态: 文件名旁会显示颜色标记
- 快速预览: 右键点击文件，选择“Compare with Repository”可快速对比本地与仓库版本
4. 常见问题与解决方法
4.1 Local Changes 选项卡未显示
如果找不到 Local Changes 选项卡，请检查以下设置：
- 点击“File (文件)” → “Settings (设置)”（macOS：
DevEco Studio→Preferences） - 在设置搜索框中输入
Commit - 找到“Commit”设置项
- 取消勾选“Use non-modal commit interface”（使用非模态提交界面）选项
- 点击“Apply”应用更改，然后重启 DevEco Studio
4.2 显示过多无关文件
如果 Local Changes 中显示大量编译生成的临时文件，需要配置.gitignore文件：
- 在项目根目录创建或编辑
.gitignore文件 - 添加以下常见鸿蒙项目排除项：
# 构建目录 build/ .hvigor/ # IDE 配置 .idea/ *.iml # 操作系统文件 .DS_Store Thumbs.db # 日志文件 *.log # 本地配置文件 local.properties - 保存文件后，运行
git rm -r --cached .清理缓存（谨慎操作）
4.3 文件状态未及时更新
如果文件状态显示不正确：
- 尝试刷新版本控制状态：
- 右键点击项目根目录
- 选择“Git” → “Refresh File Status”
- 或使用快捷键：
Ctrl + F5（Windows/Linux）或⌘ + F5（macOS）
5. 推荐配置
5.1 版本控制工具窗口布局
建议将 Version Control 工具窗口固定在合适位置：
- 拖动 Version Control 窗口标签，可将其停靠在 IDE 的左侧、右侧或底部
- 点击窗口右上角的“固定”图标，使其保持打开状态
5.2 相关设置优化
自动刷新间隔：
- 进入
Settings→Version Control→Background - 可调整自动检查更改的时间间隔
- 进入
高亮显示修改行：
- 进入
Settings→Editor→Gutter Icons - 确保“Show changes in gutter”已启用
- 进入
6. 进阶功能
6.1 创建更改列表 (Changelist)
- 在 Local Changes 窗口中，点击“+”按钮
- 输入更改列表名称（如“新功能开发”、“Bug修复”）
- 将相关文件拖动到相应列表中，便于分类管理
6.2 部分提交
- 在差异对比窗口中，右键点击特定代码块
- 选择“Commit Changes”
- 仅提交选中的代码更改，而不是整个文件
6.3 与 Git 命令行的关系
DevEco Studio 的 Local Changes 界面对应以下 Git 命令：
- 查看状态：
git status - 查看具体更改：
git diff - 暂存文件：
git add <文件名>
总结
通过 DevEco Studio 的 Version Control 工具窗口，特别是 Local Changes 选项卡，开发者可以高效地管理代码更改、查看差异内容并准备提交。合理配置相关设置可优化工作流程，提高开发效率。
注意事项：
- 定期提交更改，避免大量代码堆积在本地
- 提交前仔细查看差异内容，确保提交正确的修改
- 使用
.gitignore排除不必要的文件，保持仓库整洁
本指南基于 DevEco Studio 的通用版本控制功能和开发者社区经验整理。具体界面可能因版本不同而略有差异。
