GodotHub 项目管理入门：一键创建、导入与克隆，用分类、标签和置顶打造有序工作区-平芜编程栈

【免费下载链接】GodotHub

What if Unity Hub and GitHub Desktop had a Baby but its Adopted? Yeah..

项目地址：https://gitcode.com/gh_mirrors/godo/GodotHub

GodotHub 是一款免费开源的 Godot 项目管理工具：它能一键创建新项目、导入本地现有项目、直接克隆 Git 仓库，并用分类、标签和置顶帮你把游戏项目库整理得井井有条。

为什么需要 GodotHub

用 Godot 做游戏，项目一多就会遇到这些问题：

项目散落在各个文件夹，找起来费劲
每个项目绑定的 Godot 版本不同，容易搞混
没有统一的地方看提交状态、整理进度

GodotHub 的思路类似 Unity Hub 加 GitHub Desktop 的结合体：在 docs/WIKI-HOME.md 的官方 wiki 中，它被概括为一句话——"Manage projects, versions, assets, templates, and Git, all in one place."（项目、引擎版本、资源、模板和 Git，全在一个地方管理）。

下面进入正题：如何把项目收进来，再把工作区理清楚。

三种方式把项目收进来

打开Projects视图，右上角工具区集中了所有入口：一个Import（导入）按钮、一个Scan（扫描）按钮和一个+新建按钮，入口实现见 src/views/ProjectsView.tsx。

一键创建新项目

点击＋按钮打开创建面板（CreateProjectModal.tsx），只需三步：

填名称：输入项目名，下方会实时预览生成的文件夹名
选位置：点击浏览按钮选择保存目录（默认是首次设置时标记的"主目录"）
选版本：从已安装的 Godot 版本中挑一个绑定，例如4.3-stable

面板还提供了很多贴心选项：

可选项目模板起步，甚至可以直接预览模板内容
可指定分类，创建后直接归位
勾选Initialize Git，自动初始化仓库，还能顺手生成.gitignore、README、LICENSE（MIT / Apache-2.0 / GPL-3.0 / Unlicense）
已登录 GitHub 或 GitLab 的话，还能一键创建远程仓库并设为私有或公开

导入现有项目

电脑上已经有 Godot 项目？点Import按钮（ImportButton.tsx），在弹出的目录选择器里选中项目文件夹即可，GodotHub 会立刻把它登记进项目库。

两个更省事的补充方式：

拖拽导入：直接把项目文件夹拖进应用窗口
自动扫描：在 Settings → Storage 里配置扫描目录，之后启动应用或用Scan Now按钮，新出现的项目会被自动发现

克隆 Git 仓库

导入按钮旁边的小箭头里有一个"Clone repo"选项（CloneRepoModal.tsx），支持两种模式：

模式	用法	适合场景
Browse Repos	浏览你在 GitHub / GitLab 上已登录账号的仓库列表，直接点选	仓库已在托管平台上
URL	粘贴任意仓库地址	私有仓库、其他托管平台

选好目的地、勾选克隆完是否立即打开，点Clone & Import即可。克隆过程会在任务托盘里显示进度，完成后自动作为新项目导入，还可以顺手指定分类。

克隆进来的项目天然带有 Git 历史，直接在Git视图里就能看到分支、未提交变更，随时 commit / push / pull。认证方式见 docs/WIKI-FAQ.md：GitHub 和 GitLab 走 OAuth 设备登录，其他平台用个人访问令牌。

用分类、标签和置顶整理工作区

项目多了之后，真正的价值才开始体现。

分类（Categories）：给项目库划分区域

在 Projects 视图点标签形状的"Manage Categories"按钮（CategoryManagerModal.tsx），可以：

新建分类，自定义名称和颜色（内置丰富的配色板）
给分类绑定文件夹：放在该文件夹下的项目会自动归入此分类
折叠/展开、隐藏/恢复整个分类
直接在项目卡片上拖拽换分类，同类内也能拖拽排序

分类的好处不只是好看——搜索时还能用category:Game Jam这样的斜杠命令精确过滤。

标签（Tags）：与 Godot 启动器双向同步

GodotHub 的标签直接读写项目里的project.godot文件，也就是说：

在 Godot 启动器里加的标签，GodotHub 里同样可见
在 GodotHub 里增删标签，Godot 启动器那边也会同步

这意味着标签可以按自己的习惯打：pixel-art、completed、needs-porting……搜索时输入tag:pixel-art就能秒查。

置顶（Pin）：常用项目永远在最前面

每张项目卡片上都有一个 📌 图钉按钮，点一下项目就进入列表顶部的专属置顶区，再点一下取消。正在做的、给别人 demo 的项目，置顶就不会被淹没。

几个提升效率的小技巧

批量操作：多选项目后，可以一次性改版本、分分类、切换置顶、移出项目库
斜杠搜索：在搜索框输入/可呼出过滤菜单，tag:、category:、version:、pinned:等字段可自由组合，例如boss tag:pixel-art
模板复用：把好项目Save as Template（见 TemplatesView.tsx），以后新项目直接基于它起步，模板目录还会自动监听文件变化
版本告警：项目绑定的 Godot 版本缺失或大版本不符时，卡片上会有醒目提示，避免"打不开"的尴尬

常见问题

Q：项目没出现在列表里？先确认它的文件夹在某个扫描目录内，然后点Scan Now；如果开了文件监听，几秒内会自动识别。

Q：想重新走一遍新手引导？Settings → Advanced →Run Setup Wizard Again，已保存的设置会保留。

Q：分类功能不想要？在 Settings 里可以整体关闭分类，项目列表会回到扁平模式。

写在最后

GodotHub 把"建项目、管版本、理分类、做 Git"这条日常动线收进一个界面：创建、导入、克隆三种入口覆盖所有来源，分类、标签、置顶三层结构让项目库始终清爽。配合 docs/WIKI-GETTING-STARTED.md 的入门指南和 README.md 的完整功能清单，从安装到整理好第一个工作区，通常只需要十分钟。