Gitnuro新手常见问题解答：从安装到日常使用
项目地址: https://gitcode.com/GitHub_Trending/gi/Gitnuro Gitnuro是一款开源的跨平台Git客户端，基于JetBrains Compose和JGit开发，旨在为新手和专业用户提供无限制的Git操作体验。本文汇总了从安装到日常使用中的常见问题及解决方案，帮助用户快速上手。
安装相关问题
各操作系统安装方法
Linux用户可通过Flatpak安装：flatpak install com.jetpackduba.Gitnuro，或使用JAR文件（需JRE 17）。Windows用户可下载安装版或便携版。macOS用户可通过Homebrew安装：brew install jetpackduba/apps/gitnuro，或下载ZIP包中的应用程序 bundle。详细安装说明见README.md。
安装依赖问题
Linux ARM64/aarch64用户需安装aarch64-linux-gnu-gcc包，并添加Rust目标：rustup target add aarch64-unknown-linux-gnu。开发环境搭建需JDK 17+、Rust、cargo-kotars等依赖，详见DEVELOPMENT.md。
界面与配置
界面布局介绍
Gitnuro主界面包含菜单栏、侧边栏、提交区和历史记录区等模块。侧边栏可切换分支、标签、远程仓库等视图；提交区显示暂存和未暂存文件；历史记录区以图形化方式展示提交历史。核心功能模块路径：src/main/kotlin/com/jetpackduba/gitnuro/ui/。
主题自定义
Gitnuro支持JSON格式自定义主题，示例配置：
{
"primary": "FF456b00",
"background": "FFe7f2d3",
"addFile": "FF32A852",
"modifiedFile": "FF0070D8",
"isLight": true
}
颜色采用ARGB十六进制格式，自定义主题可能因版本更新失效，默认主题将作为回退选项。相关代码：src/main/kotlin/com/jetpackduba/gitnuro/theme/。
日常使用问题
克隆仓库
通过欢迎页面或菜单栏的"克隆仓库"功能，输入仓库URL（如https://gitcode.com/GitHub_Trending/gi/Gitnuro）、本地路径和分支，点击确认即可。克隆功能实现：src/main/kotlin/com/jetpackduba/gitnuro/git/remote_operations/CloneRepositoryUseCase.kt。
提交与推送
在提交区输入提交信息，选择要暂存的文件或代码块，点击"提交"按钮。推送前确保已配置远程仓库，通过侧边栏"远程"选项添加或编辑远程地址。提交逻辑：src/main/kotlin/com/jetpackduba/gitnuro/git/workspace/DoCommitUseCase.kt，推送功能：src/main/kotlin/com/jetpackduba/gitnuro/git/remote_operations/PushBranchUseCase.kt。
分支管理
创建分支：在侧边栏"分支"视图点击"新建分支"，输入名称并选择基于的提交或分支。切换分支：双击目标分支即可。删除本地分支：右键点击分支选择"删除"。分支操作相关代码：src/main/kotlin/com/jetpackduba/gitnuro/git/branches/。
高级功能问题
变基操作
通过历史记录区右键点击目标提交，选择"变基"，进入变基交互界面调整提交顺序或修改提交。变基过程中若遇冲突，需解决冲突后继续。变基功能实现：src/main/kotlin/com/jetpackduba/gitnuro/git/rebase/。
暂存与储藏
暂存文件：在提交区选择文件点击"暂存"，或右键选择"暂存"。储藏更改：通过菜单栏"储藏"功能，输入储藏描述后创建。应用储藏：在侧边栏"储藏"视图右键选择"应用"或"弹出"。暂存相关代码：src/main/kotlin/com/jetpackduba/gitnuro/git/workspace/StageEntryUseCase.kt，储藏功能：src/main/kotlin/com/jetpackduba/gitnuro/git/stash/。
错误与故障排除
认证失败
若使用Git凭证管理器，需在.gitconfig中指定二进制路径。Linux示例：
[credential]
helper = /usr/share/git-credential-manager-core/git-credential-manager-core
Windows示例：
[credential]
helper = C:/Program Files/Git/mingw64/bin/git-credential-manager-core.exe
多播DNS远程URL和自签名证书可能导致认证问题，详见README.md中的FAQ部分。
冲突解决
合并或变基时出现冲突，Gitnuro会标记冲突文件。在提交区打开冲突文件，编辑解决冲突后标记为已解决，继续操作。冲突处理相关代码：src/main/kotlin/com/jetpackduba/gitnuro/git/diff/。
其他常见问题
数据跟踪与隐私
Gitnuro不会跟踪任何用户数据，所有操作均在本地完成，用户可放心使用。
功能请求与bug反馈
用户可通过issue跟踪系统提交bug报告或功能建议，提交PR前建议先创建issue讨论。贡献指南见README.md。
通过本文档，用户可解决Gitnuro从安装到日常使用中的大部分问题。更多功能细节和高级用法可参考项目源码及官方文档，持续关注项目更新获取新功能。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
