Gitnuro全场景使用指南：从入门到精通

Gitnuro是一款开源跨平台Git客户端，基于JetBrains Compose和JGit开发，为新手和专业用户提供无限制的Git操作体验。本文将通过准备篇、基础篇、进阶篇和问题篇四个模块，帮助你全面掌握Gitnuro的使用方法，从环境搭建到高级功能应用，轻松应对各种开发场景。

准备篇：环境搭建与初始化

三步完成跨平台安装

1. 环境校验：执行以下命令检查系统依赖

   java -version  # 需JRE 17+
   rustc --version  # 开发环境需Rust
   

2. 选择安装方式：
   • Linux：flatpak install com.jetpackduba.Gitnuro 或下载JAR文件
   • Windows：下载安装版或便携版
   • macOS：brew install jetpackduba/apps/gitnuro 或下载ZIP包
3. 验证安装：启动Gitnuro，首次运行将显示欢迎界面，表明安装成功

🔍 新手注意事项：Linux ARM64用户需额外安装aarch64-linux-gnu-gcc包，并执行rustup target add aarch64-unknown-linux-gnu添加Rust目标。

首次配置避坑指南

1. 用户信息设置：进入设置界面，配置用户名和邮箱，这将作为提交作者信息
2. 主题选择：根据个人喜好选择浅色或深色主题，也可通过JSON文件自定义主题
3. 凭证管理：设置Git凭证管理器路径，确保远程仓库访问时无需重复输入密码

项目克隆实战操作

1. 在欢迎页面点击"克隆仓库"，或通过菜单栏"文件"→"克隆仓库"
2. 输入仓库URL：https://gitcode.com/GitHub_Trending/gi/Gitnuro
3. 选择本地存储路径，点击"克隆"按钮开始克隆过程

Gitnuro主界面展示了分支管理、提交历史和工作区状态等核心功能区域

基础篇：日常操作全掌握

核心区域与高频操作解析

Gitnuro主界面分为四大核心区域：

• 侧边栏：包含本地分支、远程仓库、标签和储藏等功能入口
• 提交历史区：以图形化方式展示提交历史和分支关系
• 工作区：显示暂存和未暂存文件
• 提交区：用于输入提交信息并执行提交操作

高频操作包括：仓库切换、分支创建、文件暂存、提交和推送等。

三步完成文件提交

1. 暂存文件：在工作区选择需要提交的文件，点击"暂存"按钮或右键选择"暂存"
2. 编写提交信息：在提交区输入清晰的提交信息，描述本次修改内容
3. 执行提交：点击"提交"按钮完成提交操作

模块功能：[src/main/kotlin/com/jetpackduba/gitnuro/git/workspace/DoCommitUseCase.kt]

🔍 新手注意事项：提交信息应简洁明了，建议遵循"动词+内容"的格式，如"Fix: 修复登录功能bug"。

分支管理实战指南

1. 创建分支：在侧边栏"分支"视图点击"新建分支"，输入名称并选择基于的提交或分支
2. 切换分支：双击目标分支即可完成切换，确保工作区无未提交更改
3. 合并分支：在目标分支上右键选择"合并"，选择要合并的源分支

在团队协作中，建议采用"feature/功能名称"的分支命名规范，便于识别和管理。

进阶篇：高级功能应用

变基操作全流程

变基(rebase)——重新排列提交历史的高级操作，可用于整理提交记录或将一个分支的更改应用到另一个分支。

1. 启动变基：在历史记录区右键点击目标提交，选择"变基"
2. 调整提交：在变基交互界面调整提交顺序或修改提交信息
3. 解决冲突：若遇冲突，编辑文件解决冲突后标记为已解决，点击"继续变基"

🔍 新手注意事项：变基操作会修改提交历史，不要对已推送到远程的提交执行变基。如操作失误，可使用git rebase --abort回滚。

模块功能：[src/main/kotlin/com/jetpackduba/gitnuro/git/rebase/]

储藏功能应用场景

储藏(stash)——临时保存工作区更改的功能，适用于需要切换分支但不想提交当前更改的场景。

1. 创建储藏：通过菜单栏"储藏"→"创建储藏"，输入描述信息
2. 应用储藏：在侧边栏"储藏"视图右键选择"应用"或"弹出"(应用后删除储藏)
3. 管理储藏：可重命名、删除或查看储藏内容

子模块管理技巧

1. 添加子模块：通过菜单栏"仓库"→"添加子模块"，输入子模块URL和路径
2. 初始化子模块：右键点击子模块选择"初始化"，或执行"初始化所有子模块"
3. 更新子模块：右键点击子模块选择"更新"，可选择拉取最新代码或切换分支

问题篇：故障排除与优化

认证失败解决方案

1. 检查凭证配置：确保.gitconfig中正确配置了凭证管理器路径

   [credential]
       helper = /usr/share/git-credential-manager-core/git-credential-manager-core
   

2. 查看错误日志：日志路径位于用户目录下的.gitnuro/logs文件夹
3. 常见错误码解读：
   • 401：未授权，检查用户名密码是否正确
   • 403：权限不足，确认是否有仓库访问权限
   • 404：仓库不存在，检查仓库URL是否正确

冲突解决详细步骤

1. 识别冲突文件：合并或变基时，冲突文件会被标记
2. 编辑冲突文件：打开冲突文件，查找并解决冲突标记<<<<<<< HEAD和>>>>>>> branch-name之间的内容
3. 标记为已解决：解决冲突后，在工作区右键点击文件选择"标记为已解决"
4. 继续操作：点击"继续合并"或"继续变基"完成操作

模块功能：[src/main/kotlin/com/jetpackduba/gitnuro/git/diff/]

🔍 新手注意事项：解决冲突时，建议与团队成员沟通确认正确的代码版本，避免误删重要代码。

性能优化实用技巧

1. 减少历史记录加载：在设置中调整"最大提交历史数量"，减少内存占用
2. 关闭不必要的功能：如不需要文件变化监视，可在设置中禁用
3. 定期清理缓存：通过"帮助"→"清理缓存"功能，删除临时文件和缓存数据

通过以上四个模块的学习，你已经掌握了Gitnuro的核心功能和使用技巧。无论是日常的提交、分支管理，还是高级的变基操作，Gitnuro都能为你提供直观高效的操作体验。在使用过程中，遇到问题可查阅日志文件或提交issue获取帮助。祝你的Git使用之旅更加顺畅！