在 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 文件

添加以下常见鸿蒙项目排除项：

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 的通用版本控制功能和开发者社区经验整理。具体界面可能因版本不同而略有差异。