Fork Git 可视化客户端 完整使用说明书文档版本V1.0适用平台Windows / macOS面向人群研发开发人员Fork 是图形化 Git 工具本手册覆盖【全部菜单功能、日常开发、高级特性、故障排查、安全规范】可作为团队正式文档。目录软件概述安装与首次初始化配置顶部菜单栏完整参考File / View / Repository / Window / Help仓库基础操作克隆、打开、新建仓库日常开发标准工作流分支管理常规分支 Worktree 多工作树重点提交管理、交互式变基、历史整理远端同步Fetch / Pull / Push 详解暂存 Stash、Cherry-pick、Revert、冲突处理Git Flow、Git LFS、Patch、Bisect 高级功能账号、SSH密钥配置快捷键大全安全规范与风险禁令常见问题故障排查1. 软件概述Fork 是轻量商用 Git 图形客户端替代命令行执行 Git 操作核心优势清晰提交图谱、可视化交互式变基、原生支持 Git Worktree、友好冲突解决面板。重要概念区分本地Commit仅保存在本机必须 Push 才同步远端Worktree同一仓库多个独立本地目录可同时运行多个分支交互式变基 rebase -i整理本地提交历史禁止作用于已推送公共分支2. 安装与首次初始化配置2.1 安装激活官网下载对应系统安装包Help → Fork Activation...输入授权密钥完成激活未激活存在功能限制。2.2 基础全局配置File → Preferences...General设置用户名、邮箱与Git仓库提交身份保持一致External Editors绑定 VSCode / WebStorm 等代码编辑器支持右键直接打开文件Commits配置提交信息模板推荐遵循规范type(scope): messagefeat新功能 /fix缺陷修复 /refactor重构 /docs文档 /style样式调整Diff开启换行对比、空白字符高亮方便代码冲突排查Terminal配置系统终端路径支持在仓库目录快速唤起命令行2.3 远程仓库连接配置两种协议二选一SSH协议推荐无需重复输入账号密码File → Configure SSH Keys...生成/导入本地私钥将公钥配置到 Codeup / Gitee / GitHub 个人账号。HTTPS协议File → Accounts...添加平台账号保存凭证。3. 顶部菜单栏完整参考3.1 File 菜单全局仓库管理选项快捷键功能Init New RepositoryCtrlShiftN在本地文件夹初始化全新Git仓库git initCloneCtrlN克隆远端仓库到本地New TabCtrlT新建标签页同时打开多个仓库Open RepositoryCtrlO打开本地已有Git仓库选中包含.git的根目录Quick LaunchCtrlP快速检索、切换历史打开仓库Close TabCtrlW关闭当前仓库标签Restore Closed TabCtrlShiftT恢复关闭的标签页Configure SSH Keys—SSH密钥管理Accounts—HTTPS平台账号凭证管理Check for Updates—检测软件新版本PreferencesCtrl,全局参数设置Exit—退出Fork程序3.2 View 菜单界面视图控制显示/隐藏分支面板、文件变更列表、提交详情、文件树切换浅色/深色主题刷新视图、调整Diff展示模式横向/纵向对比缩放界面、重置布局3.3 Repository 菜单当前仓库核心Git操作选项快捷键功能RefreshF5刷新仓库状态FetchCtrlShiftF拉取远端分支信息不修改本地代码PullCtrlShiftLFetch Merge拉取远端代码合并到本地PushCtrlShiftP推送本地提交到远端仓库Save StashCtrlShiftH暂存未提交的工作区改动New BranchCtrlShiftB在当前仓库新建分支共享文件夹New TagCtrlShiftG创建版本标签Tag用于发版标记New Worktree—创建独立工作目录并行多分支开发Git Flow—分支流程插件Feature/Release/HotfixGit LFS—大文件存储管理图片、压缩包、二进制资源Apply Patch—导入.patch补丁文件应用改动Bisect—二分查找定位引入Bug的提交Open In File ExplorerCtrlAltO在资源管理器打开仓库目录Open In ConsoleCtrlAltT唤起终端并定位到仓库路径Repository Statistics—仓库贡献、提交统计报表Repository Treemap—文件大小可视化图表Settings for This Repository—单仓库独立配置覆盖全局设置3.4 Window 菜单窗口布局管理、切换标签、最小化、重置面板布局。3.5 Help 菜单Contact Support联系官方支持Visit Fork Website访问官网Issue Tracker查看官方Bug列表Keyboard Shortcuts全部快捷键清单Release Notes版本更新日志Fork Activation软件激活入口About Fork查看软件版本信息4. 仓库基础操作4.1 克隆远端仓库File → Clone填入仓库SSH/HTTPS地址选择本地存放路径点击Clone等待下载完成4.2 打开本地已有仓库File → Open Repository选中仓库根目录必须包含隐藏文件夹.git4.3 新建本地空白仓库File → Init New Repository选择空文件夹初始化Git仓库。5. 日常开发标准工作流标准流程单人单目录开发Repository → Fetch拉取远端最新信息确认远端无冲突更新后执行Pull基于基准分支一般develop新建功能分支编写代码左侧变更面板查看改动文件勾选文件填写规范Commit信息点击【Commit】仅提交本地开发完成整理提交历史交互式rebasePush将分支推送远端在代码平台提交 MR/PR申请合并至目标分支⚠️ Commit 只是本地快照不执行Push远端仓库无法看到你的代码6. 分支管理6.1 普通分支 New BranchRepository → New Branch特点共用当前代码文件夹切换分支会覆盖本地文件适用一次只开发一个任务分支命名规范需求开发feature/任务标识-功能描述缺陷修复fix/缺陷编号-问题描述紧急线上修复hotfix/版本-问题描述6.2 Worktree 多工作树【重点高级功能】解决痛点需要同时操作多个分支不想反复stash暂存代码创建方式方式1Repository → New Worktree...方式2分支右键 → Create Worktree弹窗参数Start from选择基准分支developBranch name填写新分支名称Location统一目录存放所有worktree推荐D:\workspace\xxx-worktrees使用规范每个Worktree拥有独立代码目录可使用多个编辑器同时打开禁止直接在资源管理器删除Worktree文件夹删除操作Fork内右键对应Worktree → Remove清理仓库内部注册信息Worktree目录不要嵌套在主仓库文件夹内避免异常适用场景并行开发多个需求、开发中临时处理线上紧急Bug、同时调试多个版本分支区分对比New Branch同一文件夹切换分支覆盖文件New Worktree独立文件夹多分支同时并行开发7. 提交历史管理交互式变基 Interactive Rebase⚠️强制红线仅允许操作【未Push到远端】的本地提交develop/main公共分支一旦推送远端禁止执行rebase会造成团队历史断裂在提交记录上右键 →Interactive Rebase选项作用适用场景Reword修改当前提交备注代码不变commit注释写错需要规范化文案Edit暂停变基允许修改代码后继续当前提交漏写代码需要补充改动Squash into Parent将当前提交合并到上一条弹窗允许重新编辑全部提交信息需要保留多条提交说明整合为一条Fixup into Parent将当前提交合并到上一条丢弃本条注释沿用父提交文案主提交后的小修复无痕合并最常用Drop彻底删除本次提交所有改动移除无用测试提交、误提交清理安全操作建议执行交互式变基前建议先创建临时备份分支操作失误可回滚。8. 远端同步 Fetch / Pull / Push 完整说明Fetch推荐优先执行拉取远端所有分支、提交信息不会修改本地任何文件安全预览远端更新。开发习惯每次开工先Fetch观察远端变化Pull Fetch Merge拉取远端代码并自动合并到本地当前分支。不建议频繁直接Pull优先Fetch确认更新。Push将本地新增Commit上传至远程仓库。注意本地执行rebase整理历史后首次推送需要强制推送公共分支develop/main严禁强制推送会覆盖其他开发人员代码。9. 通用高级操作9.1 Stash 暂存代码场景代码写到一半需要切换分支处理紧急任务暂时不想提交半成品Repository → Save Stash...Pop应用暂存改动同时删除暂存记录Apply应用改动保留暂存记录可重复使用Drop删除这条暂存9.2 Cherry-pick 拾取提交右键目标Commit →Cherry-pick Commit...将单条提交复制到当前分支常用于把修复补丁同步到多个版本分支。9.3 Revert 安全撤销提交公共分支专用如果代码已经推送到远端公共分支不能删除历史禁止rebase右键提交 →Revert Commit...自动生成一条反向提交移除原有改动历史完整保留多人协作安全。9.4 冲突处理触发时机Pull / Merge / Rebase / Cherry-pick弹出冲突面板逐文件对比差异可选保留本地版本 / 保留远端版本 / 手动编辑合并全部冲突解决完成后点击Continue完成操作10. 其他高级工具Git Flow标准化分支模型feature → develop → release → main → hotfix适合有正式发版周期项目。Git LFS追踪大文件图片、视频、压缩包、设计资源避免仓库体积持续膨胀。Apply Patch导出/导入patch补丁用于跨仓库传递少量代码改动。Bisect二分查找自动化遍历提交快速定位哪一次提交引入Bug。11. 完整快捷键汇总快捷键功能Ctrl,打开全局设置 PreferencesCtrlNClone 克隆仓库CtrlOOpen Repository 打开仓库CtrlShiftNInit New Repository 新建仓库CtrlShiftBNew Branch 新建分支CtrlShiftFFetchCtrlShiftLPullCtrlShiftPPushCtrlShiftHSave Stash 暂存CtrlTNew TabCtrlWClose TabCtrlAltO在资源管理器打开目录CtrlAltT打开终端F5Refresh 刷新仓库12. 安全规范 禁令 ⚠️❌ 严禁对已推送到远端的 develop / main 公共分支执行交互式rebase❌ 多人协作公共分支禁止使用强制推送Push --force极易覆盖同事代码❌ Worktree 文件夹不要嵌套在主仓库目录内❌ 不要直接手动删除Worktree文件夹必须在Fork内执行Remove✅ 提交历史整理仅在个人未推送的功能分支操作✅ 公共分支代码回滚统一使用 Revert不使用Reset/Drop✅ 日常同步远端代码优先Fetch预览更新确认无风险再Pull13. 常见故障排查问题1Push推送失败提示远端有新提交解决方案先Fetch → Pull合并远端代码解决冲突后再Push。问题2SSH推送提示权限拒绝解决方案检查Configure SSH Keys内私钥配置确认公钥已经上传代码平台账号。问题3Worktree目录异常、无法切换分支解决方案不要手动删除文件夹在Fork中移除异常Worktree必要时清理.git/worktrees目录。问题4交互式rebase执行一半卡住、冲突无法解决解决方案点击Abort终止本次rebase回到操作前状态优先使用提前创建的备份分支恢复。问题5提交信息中文乱码解决方案File → Preferences调整Git编码设置确认系统终端编码为UTF-8。如果你需要我可以输出两种格式纯Markdown文本直接复制到知识库调整段落、标题样式适配导出Word文档。
Fork Git 可视化客户端 完整使用说明书
Fork Git 可视化客户端 完整使用说明书文档版本V1.0适用平台Windows / macOS面向人群研发开发人员Fork 是图形化 Git 工具本手册覆盖【全部菜单功能、日常开发、高级特性、故障排查、安全规范】可作为团队正式文档。目录软件概述安装与首次初始化配置顶部菜单栏完整参考File / View / Repository / Window / Help仓库基础操作克隆、打开、新建仓库日常开发标准工作流分支管理常规分支 Worktree 多工作树重点提交管理、交互式变基、历史整理远端同步Fetch / Pull / Push 详解暂存 Stash、Cherry-pick、Revert、冲突处理Git Flow、Git LFS、Patch、Bisect 高级功能账号、SSH密钥配置快捷键大全安全规范与风险禁令常见问题故障排查1. 软件概述Fork 是轻量商用 Git 图形客户端替代命令行执行 Git 操作核心优势清晰提交图谱、可视化交互式变基、原生支持 Git Worktree、友好冲突解决面板。重要概念区分本地Commit仅保存在本机必须 Push 才同步远端Worktree同一仓库多个独立本地目录可同时运行多个分支交互式变基 rebase -i整理本地提交历史禁止作用于已推送公共分支2. 安装与首次初始化配置2.1 安装激活官网下载对应系统安装包Help → Fork Activation...输入授权密钥完成激活未激活存在功能限制。2.2 基础全局配置File → Preferences...General设置用户名、邮箱与Git仓库提交身份保持一致External Editors绑定 VSCode / WebStorm 等代码编辑器支持右键直接打开文件Commits配置提交信息模板推荐遵循规范type(scope): messagefeat新功能 /fix缺陷修复 /refactor重构 /docs文档 /style样式调整Diff开启换行对比、空白字符高亮方便代码冲突排查Terminal配置系统终端路径支持在仓库目录快速唤起命令行2.3 远程仓库连接配置两种协议二选一SSH协议推荐无需重复输入账号密码File → Configure SSH Keys...生成/导入本地私钥将公钥配置到 Codeup / Gitee / GitHub 个人账号。HTTPS协议File → Accounts...添加平台账号保存凭证。3. 顶部菜单栏完整参考3.1 File 菜单全局仓库管理选项快捷键功能Init New RepositoryCtrlShiftN在本地文件夹初始化全新Git仓库git initCloneCtrlN克隆远端仓库到本地New TabCtrlT新建标签页同时打开多个仓库Open RepositoryCtrlO打开本地已有Git仓库选中包含.git的根目录Quick LaunchCtrlP快速检索、切换历史打开仓库Close TabCtrlW关闭当前仓库标签Restore Closed TabCtrlShiftT恢复关闭的标签页Configure SSH Keys—SSH密钥管理Accounts—HTTPS平台账号凭证管理Check for Updates—检测软件新版本PreferencesCtrl,全局参数设置Exit—退出Fork程序3.2 View 菜单界面视图控制显示/隐藏分支面板、文件变更列表、提交详情、文件树切换浅色/深色主题刷新视图、调整Diff展示模式横向/纵向对比缩放界面、重置布局3.3 Repository 菜单当前仓库核心Git操作选项快捷键功能RefreshF5刷新仓库状态FetchCtrlShiftF拉取远端分支信息不修改本地代码PullCtrlShiftLFetch Merge拉取远端代码合并到本地PushCtrlShiftP推送本地提交到远端仓库Save StashCtrlShiftH暂存未提交的工作区改动New BranchCtrlShiftB在当前仓库新建分支共享文件夹New TagCtrlShiftG创建版本标签Tag用于发版标记New Worktree—创建独立工作目录并行多分支开发Git Flow—分支流程插件Feature/Release/HotfixGit LFS—大文件存储管理图片、压缩包、二进制资源Apply Patch—导入.patch补丁文件应用改动Bisect—二分查找定位引入Bug的提交Open In File ExplorerCtrlAltO在资源管理器打开仓库目录Open In ConsoleCtrlAltT唤起终端并定位到仓库路径Repository Statistics—仓库贡献、提交统计报表Repository Treemap—文件大小可视化图表Settings for This Repository—单仓库独立配置覆盖全局设置3.4 Window 菜单窗口布局管理、切换标签、最小化、重置面板布局。3.5 Help 菜单Contact Support联系官方支持Visit Fork Website访问官网Issue Tracker查看官方Bug列表Keyboard Shortcuts全部快捷键清单Release Notes版本更新日志Fork Activation软件激活入口About Fork查看软件版本信息4. 仓库基础操作4.1 克隆远端仓库File → Clone填入仓库SSH/HTTPS地址选择本地存放路径点击Clone等待下载完成4.2 打开本地已有仓库File → Open Repository选中仓库根目录必须包含隐藏文件夹.git4.3 新建本地空白仓库File → Init New Repository选择空文件夹初始化Git仓库。5. 日常开发标准工作流标准流程单人单目录开发Repository → Fetch拉取远端最新信息确认远端无冲突更新后执行Pull基于基准分支一般develop新建功能分支编写代码左侧变更面板查看改动文件勾选文件填写规范Commit信息点击【Commit】仅提交本地开发完成整理提交历史交互式rebasePush将分支推送远端在代码平台提交 MR/PR申请合并至目标分支⚠️ Commit 只是本地快照不执行Push远端仓库无法看到你的代码6. 分支管理6.1 普通分支 New BranchRepository → New Branch特点共用当前代码文件夹切换分支会覆盖本地文件适用一次只开发一个任务分支命名规范需求开发feature/任务标识-功能描述缺陷修复fix/缺陷编号-问题描述紧急线上修复hotfix/版本-问题描述6.2 Worktree 多工作树【重点高级功能】解决痛点需要同时操作多个分支不想反复stash暂存代码创建方式方式1Repository → New Worktree...方式2分支右键 → Create Worktree弹窗参数Start from选择基准分支developBranch name填写新分支名称Location统一目录存放所有worktree推荐D:\workspace\xxx-worktrees使用规范每个Worktree拥有独立代码目录可使用多个编辑器同时打开禁止直接在资源管理器删除Worktree文件夹删除操作Fork内右键对应Worktree → Remove清理仓库内部注册信息Worktree目录不要嵌套在主仓库文件夹内避免异常适用场景并行开发多个需求、开发中临时处理线上紧急Bug、同时调试多个版本分支区分对比New Branch同一文件夹切换分支覆盖文件New Worktree独立文件夹多分支同时并行开发7. 提交历史管理交互式变基 Interactive Rebase⚠️强制红线仅允许操作【未Push到远端】的本地提交develop/main公共分支一旦推送远端禁止执行rebase会造成团队历史断裂在提交记录上右键 →Interactive Rebase选项作用适用场景Reword修改当前提交备注代码不变commit注释写错需要规范化文案Edit暂停变基允许修改代码后继续当前提交漏写代码需要补充改动Squash into Parent将当前提交合并到上一条弹窗允许重新编辑全部提交信息需要保留多条提交说明整合为一条Fixup into Parent将当前提交合并到上一条丢弃本条注释沿用父提交文案主提交后的小修复无痕合并最常用Drop彻底删除本次提交所有改动移除无用测试提交、误提交清理安全操作建议执行交互式变基前建议先创建临时备份分支操作失误可回滚。8. 远端同步 Fetch / Pull / Push 完整说明Fetch推荐优先执行拉取远端所有分支、提交信息不会修改本地任何文件安全预览远端更新。开发习惯每次开工先Fetch观察远端变化Pull Fetch Merge拉取远端代码并自动合并到本地当前分支。不建议频繁直接Pull优先Fetch确认更新。Push将本地新增Commit上传至远程仓库。注意本地执行rebase整理历史后首次推送需要强制推送公共分支develop/main严禁强制推送会覆盖其他开发人员代码。9. 通用高级操作9.1 Stash 暂存代码场景代码写到一半需要切换分支处理紧急任务暂时不想提交半成品Repository → Save Stash...Pop应用暂存改动同时删除暂存记录Apply应用改动保留暂存记录可重复使用Drop删除这条暂存9.2 Cherry-pick 拾取提交右键目标Commit →Cherry-pick Commit...将单条提交复制到当前分支常用于把修复补丁同步到多个版本分支。9.3 Revert 安全撤销提交公共分支专用如果代码已经推送到远端公共分支不能删除历史禁止rebase右键提交 →Revert Commit...自动生成一条反向提交移除原有改动历史完整保留多人协作安全。9.4 冲突处理触发时机Pull / Merge / Rebase / Cherry-pick弹出冲突面板逐文件对比差异可选保留本地版本 / 保留远端版本 / 手动编辑合并全部冲突解决完成后点击Continue完成操作10. 其他高级工具Git Flow标准化分支模型feature → develop → release → main → hotfix适合有正式发版周期项目。Git LFS追踪大文件图片、视频、压缩包、设计资源避免仓库体积持续膨胀。Apply Patch导出/导入patch补丁用于跨仓库传递少量代码改动。Bisect二分查找自动化遍历提交快速定位哪一次提交引入Bug。11. 完整快捷键汇总快捷键功能Ctrl,打开全局设置 PreferencesCtrlNClone 克隆仓库CtrlOOpen Repository 打开仓库CtrlShiftNInit New Repository 新建仓库CtrlShiftBNew Branch 新建分支CtrlShiftFFetchCtrlShiftLPullCtrlShiftPPushCtrlShiftHSave Stash 暂存CtrlTNew TabCtrlWClose TabCtrlAltO在资源管理器打开目录CtrlAltT打开终端F5Refresh 刷新仓库12. 安全规范 禁令 ⚠️❌ 严禁对已推送到远端的 develop / main 公共分支执行交互式rebase❌ 多人协作公共分支禁止使用强制推送Push --force极易覆盖同事代码❌ Worktree 文件夹不要嵌套在主仓库目录内❌ 不要直接手动删除Worktree文件夹必须在Fork内执行Remove✅ 提交历史整理仅在个人未推送的功能分支操作✅ 公共分支代码回滚统一使用 Revert不使用Reset/Drop✅ 日常同步远端代码优先Fetch预览更新确认无风险再Pull13. 常见故障排查问题1Push推送失败提示远端有新提交解决方案先Fetch → Pull合并远端代码解决冲突后再Push。问题2SSH推送提示权限拒绝解决方案检查Configure SSH Keys内私钥配置确认公钥已经上传代码平台账号。问题3Worktree目录异常、无法切换分支解决方案不要手动删除文件夹在Fork中移除异常Worktree必要时清理.git/worktrees目录。问题4交互式rebase执行一半卡住、冲突无法解决解决方案点击Abort终止本次rebase回到操作前状态优先使用提前创建的备份分支恢复。问题5提交信息中文乱码解决方案File → Preferences调整Git编码设置确认系统终端编码为UTF-8。如果你需要我可以输出两种格式纯Markdown文本直接复制到知识库调整段落、标题样式适配导出Word文档。