快速开始¶
通过这篇指南，您将在 5 分钟内完成开发环境配置，并开启 GoGraph 图数据库之旅。
1. 安装命令行工具 (推荐)¶
探索 GoGraph 最快的方式是使用其命令行界面（CLI）。
macOS / Linux (Homebrew):
运行交互式 Shell (TUI):
2. 作为 Go 库安装¶
在您的 Go Module 项目目录下执行以下命令获取依赖：
3. 基础使用示例¶
下面演示一个完整的 main.go 示例。
package main
import (
"context"
"fmt"
"log"
"github.com/DotNetAge/gograph/pkg/api"
)
func main() {
// 1. 打开或创建一个图数据库实例 (默认路径 default.db)
db, err := api.Open("default.db")
if err != nil {
log.Fatalf("Failed to open db: %v", err)
}
defer db.Close()
ctx := context.Background()
// 2. 使用 Cypher 写入数据
db.Exec(ctx, "CREATE (a:User {name: 'Alice'})-[:KNOWS]->(b:User {name: 'Bob'})")
// 3. 执行数据查询 (MATCH ... RETURN)
rows, err := db.Query(ctx, "MATCH (u:User)-[:KNOWS]->(friend:User) RETURN u.name, friend.name")
if err != nil {
log.Fatalf("Query failed: %v", err)
}
defer rows.Close()
// 4. 遍历结果集
for rows.Next() {
var uName, fName string
if err := rows.Scan(&uName, &fName); err == nil {
fmt.Printf("%s knows %s\n", uName, fName)
}
}
}