参与 HugeGraph 社区

选择贡献方式

可以通过 GitHub Issues 报告问题，也可以提交代码、测试或文档。准备较大的改动前，建议先创建 Issue 并说明范围，避免重复工作。

下面以 apache/hugegraph 为例。其他 HugeGraph 仓库的流程相同，但构建和测试命令应以各仓库的 README.md、AGENTS.md 和 CI 配置为准。

准备仓库

先在 GitHub 上 fork apache/hugegraph，再克隆自己的 fork：

1git clone https://github.com/<your-name>/hugegraph.git
2cd hugegraph
3git remote add upstream https://github.com/apache/hugegraph.git
4git fetch upstream master

不要直接在 master 上开发。每项改动使用单独分支：

1git switch master
2git merge --ff-only upstream/master
3git switch -c fix/<short-description>

修改和验证

HugeGraph Server 的代码位于 hugegraph-server/。例如，核心模块路径是：

1hugegraph-server/hugegraph-core/src/main/java/org/apache/hugegraph/

当前主仓库根目录的 Maven 模块如下；Server 的存储适配器 hugegraph-server/hugegraph-hstore/ 与独立的存储节点项目 hugegraph-store/ 是不同模块。

路径	子模块
`hugegraph-server/`	`hugegraph-core/`、`hugegraph-api/`、`hugegraph-example/`、`hugegraph-dist/`、`hugegraph-test/`、`hugegraph-rocksdb/`、`hugegraph-hbase/`、`hugegraph-hstore/`
`hugegraph-pd/`	`hg-pd-common/`、`hg-pd-client/`、`hg-pd-core/`、`hg-pd-service/`、`hg-pd-dist/`、`hg-pd-cli/`、`hg-pd-grpc/`、`hg-pd-test/`
`hugegraph-store/`	`hg-store-common/`、`hg-store-client/`、`hg-store-core/`、`hg-store-node/`、`hg-store-dist/`、`hg-store-cli/`、`hg-store-grpc/`、`hg-store-rocksdb/`、`hg-store-test/`
`hugegraph-commons/`	`hugegraph-common/`、`hugegraph-rpc/`
`hugegraph-cluster-test/`	`hugegraph-clustertest-minicluster/`、`hugegraph-clustertest-dist/`、`hugegraph-clustertest-test/`
独立根模块	`hugegraph-struct/`、`install-dist/`

上述名称来自根 pom.xml 及各子项目 pom.xml；代码结构以正在使用的分支为准。

已合入 Server master、面向 1.8.0 的整合见共享基础模块职责和 Java 迁移指南。

当前 Server master 使用 Java 17 和 Maven 3.6.3 或更高版本构建。 CI-friendly 版本在 process-resources 阶段展开，安装或发布的 POM 使用具体版本号。单独构建模块前，先对整仓执行 install；使用 Maven 3.10 时也应保持 Resolver 校验开启。

先运行与改动直接相关的测试。Server 常用测试入口如下：

1# Core 测试，使用内存后端
2mvn test -pl hugegraph-server/hugegraph-test -am -P core-test,memory
3
4# API 测试，使用 RocksDB 后端
5mvn test -pl hugegraph-server/hugegraph-test -am -P api-test,rocksdb
6
7# 格式化并检查编译
8mvn editorconfig:format
9mvn clean compile -Dmaven.javadoc.skip=true

GitHub 已不支持通过用户名和密码直接推送代码。需要使用个人访问令牌时，请在令牌设置页创建并按需授权：

提交第三方依赖时，还要同步发行包中的许可证信息：

把依赖的许可证文件放入 install-dist/release-docs/licenses/。
更新 install-dist/release-docs/LICENSE；依赖包含 NOTICE 时，同时更新 NOTICE。
在仓库根目录，先准备当前 revision 的 Server、PD、Store 发行包库，再生成依赖清单：
```
1mvn clean install -DskipTests -Dmaven.javadoc.skip=true
2bash install-dist/scripts/dependency/regenerate_known_dependencies.sh
```
clean 会重新构建当前版本的发行目录，避免残留已移除的依赖 jar。它还会删除 hugegraph-server/、hugegraph-pd/ 与 hugegraph-store/ 目录下的所有 *.tar 和 *.tar.gz 文件，以及仓库根目录中当前版本的 apache-hugegraph-<revision>.tar.gz；其他版本的目录会保留。
此构建跳过测试。依赖收集同时覆盖 Maven runtime 依赖和实际发行包中的平铺、嵌套 jar，包括 Spring Boot repackaging 引入的 BOOT-INF/lib 依赖。缺失发行包必须使收集失败；只检查 POM 不能证明完整发行依赖集。核查 install-dist/scripts/dependency/known-dependencies.txt 的严格增删对比及对应 license/NOTICE，并按需覆盖发布平台和 profile 变体。

提交 Pull Request

提交代码所用的邮箱需要绑定到 GitHub 账号。请在邮箱设置页完成绑定：

提交信息使用 type(module): message 格式，例如：

1git add <changed-files>
2git commit -m "fix(core): handle empty vertex query"
3git push -u origin fix/<short-description>

然后从 fork 分支向 apache/hugegraph:master 创建 Pull Request。说明问题、修改方法和实际运行的验证命令；界面变化应附截图。

处理 Review

CI 失败或 reviewer 要求修改时，在原分支继续提交并推送。需要同步上游时，可以 rebase：

1git fetch upstream master
2git rebase upstream/master
3git push --force-with-lease

不要使用普通 --force 覆盖远端分支。完成所有 CI 和 review 要求后，由项目 maintainer 合并 Pull Request。

Contributor Agreement 使用 ASF 官方流程，见贡献者协议。