Gitnuro全方位操作指南：从新手到高手的Git客户端实践

入门准备：从零开始的环境搭建

跨平台安装方案

痛点：不同系统安装步骤混乱
解决方案：根据操作系统选择对应安装方式

Windows用户：

1. 下载安装版或便携版压缩包
2. 解压至任意目录（建议无中文路径）
3. 双击Gitnuro.exe启动程序

macOS用户：

1. 执行brew install jetpackduba/apps/gitnuro
2. 或下载ZIP包并拖拽应用至Applications文件夹
3. 首次启动需在系统偏好设置中允许来自开发者的应用

Linux用户：

1. Flatpak安装：flatpak install com.jetpackduba.Gitnuro
2. 或使用JAR文件：java -jar Gitnuro.jar（需JRE 17+）
3. ARM64架构需额外执行：rustup target add aarch64-unknown-linux-gnu

🔍 验证方法：启动程序后能看到欢迎界面即安装成功

初始配置优化

痛点：默认设置不适合个人习惯
解决方案：完成三项关键配置

1. 打开设置（右上角齿轮图标）
2. 在"用户信息"页填写用户名和邮箱
3. 在"外观"页选择主题模式（浅色/深色）
4. 配置默认编辑器路径（如VS Code：code --wait）

💡 技巧：勾选"记住最近打开的仓库"可提高工作效率

避坑指南

1. ❌ 安装路径包含中文或特殊字符：可能导致程序启动失败
2. ❌ 使用过时JRE版本：需确保JRE 17及以上版本
3. ❌ 忽略权限请求：macOS首次运行需允许"系统偏好设置-安全性与隐私"中的应用访问

核心操作：日常开发必备技能

仓库克隆与创建

痛点：新手不知如何开始项目
解决方案：两种方式获取项目仓库

克隆远程仓库：

1. 点击欢迎页面"克隆仓库"按钮
2. 输入仓库URL：https://gitcode.com/GitHub_Trending/gi/Gitnuro
3. 选择本地存储路径
4. 点击"克隆"按钮开始下载

创建新仓库：

1. 点击菜单栏"文件>新建仓库"
2. 选择存储位置并输入仓库名称
3. 勾选"初始化Git仓库"选项
4. 点击"创建"完成初始化

🔍 验证方法：仓库列表出现新项目且文件结构完整

提交与推送工作流

痛点：代码提交流程不清晰
解决方案：四步完成代码提交推送

1. 在"未暂存"区域选择需要提交的文件
2. 点击文件旁"+"按钮或右键选择"暂存"
3. 在提交信息框输入描述（建议遵循"类型: 简短描述"格式）
4. 点击"提交"按钮，完成后点击"推送"图标

⚠️ 注意：提交信息应清晰描述变更内容，便于后续追溯

避坑指南

1. ❌ 提交信息过于简单：如"fix"、"update"，导致历史难以理解
2. ❌ 推送前未拉取最新代码：可能引发冲突
3. ❌ 暂存错误文件：如node_modules等依赖文件不应提交

进阶技巧：提升效率的高级功能

分支管理艺术

痛点：多分支并行开发混乱
解决方案：规范的分支操作流程

创建分支：

1. 在侧边栏"分支"视图点击"+"按钮
2. 输入分支名称（建议使用feature/xxx格式）
3. 选择基于的源分支（通常是main或develop）
4. 点击"创建"完成分支创建

切换分支：

1. 在分支列表中找到目标分支
2. 双击分支名称或右键选择"切换"
3. 如提示有未提交更改，选择"储藏"或"提交"

合并分支：

1. 切换到接收更改的分支（如main）
2. 右键目标分支选择"合并"
3. 解决可能出现的冲突
4. 完成合并后推送更改

💡 技巧：定期从主分支同步更新到功能分支，减少冲突

变基操作详解

痛点：提交历史杂乱无章
解决方案：使用变基(rebase)：通过改写提交历史实现分支整合

交互式变基：

1. 在历史记录区右键目标提交
2. 选择"变基"进入交互界面
3. 对提交进行调整（修改、合并、删除）
4. 保存更改并解决可能的冲突
5. 完成变基后强制推送（需谨慎使用）

⚠️ 注意：不要对已推送到公共仓库的提交使用变基

避坑指南

1. ❌ 在公共分支上执行变基：会破坏团队协作历史
2. ❌ 变基过程中强制退出：可能导致仓库处于不一致状态
3. ❌ 不理解变基与合并的区别：变基改写历史，合并保留历史

问题诊断：常见故障排除方案

认证问题解决

痛点：远程操作时认证失败
解决方案：配置凭证管理器

1. 打开终端执行git config --global credential.helper检查当前配置
2. 根据系统设置正确的凭证管理器路径：

   # Linux示例
   git config --global credential.helper /usr/share/git-credential-manager-core/git-credential-manager-core
   
   # Windows示例
   git config --global credential.helper "C:/Program Files/Git/mingw64/bin/git-credential-manager-core.exe"
   

3. 重启Gitnuro使配置生效

🔍 验证方法：执行推送操作不再提示输入用户名密码

冲突解决流程

痛点：合并或变基时遇到冲突
解决方案：四步冲突解决法

1. 识别冲突文件：标记为"冲突"状态的文件
2. 双击打开冲突文件，找到<<<<<<< HEAD标记的冲突区域
3. 编辑文件保留正确内容，删除冲突标记
4. 标记为"已解决"并完成合并/变基操作

💡 技巧：使用可视化对比工具可更直观解决复杂冲突

避坑指南

1. ❌ 直接删除冲突标记：可能导致代码逻辑错误
2. ❌ 解决冲突后忘记标记为已解决：导致操作无法继续
3. ❌ 不理解冲突产生原因：应先理解代码变更意图再解决

核心概念速查表

术语	解释
暂存区(Staging Area)	提交前存放变更的中间区域，可理解为"待提交清单"
变基(Rebase)	通过改写提交历史实现分支整合，使历史更线性
暂存(Stash)	临时保存未提交的更改，可理解为"剪贴板"
远程仓库(Remote)	托管在网络上的仓库副本，用于团队协作
冲突(Conflict)	多人修改同一文件同一位置导致的合并矛盾
HEAD	当前工作目录所指向的分支或提交的指针
分支(Branch)	独立的代码开发线，可理解为"平行宇宙"

提交功能实现
分支管理模块
变基功能实现