MongoDB 官方 Go 语言驱动使用指南-Golang-PHP中文网

MongoDB 官方 Go 语言驱动使用指南

MongoDB 官方并未提供由其团队直接维护的 Go 语言驱动，而是推荐社区支持的 mgo（后演进为 mongo-go-driver）；自 MongoDB 3.6+ 起，官方正式推出并主推 go.mongodb.org/mongo-driver/mongo，功能完整、持续更新，已成为现代 Go 应用连接 MongoDB 的标准选择。

mongodb 官方并未提供由其团队直接维护的 go 语言驱动，而是推荐社区支持的 `mgo`（后演进为 `mongo-go-driver`）；自 mongodb 3.6+ 起，官方正式推出并主推 `go.mongodb.org/mongo-driver/mongo`，功能完整、持续更新，已成为现代 go 应用连接 mongodb 的标准选择。

早在 MongoDB 3.4 时代（如问题所述），Go 社区主流使用的确实是 mgo，它由 Canonical 工程师 Gustavo Niemeyer 主导开发，曾被 MongoDB 官方文档列为社区支持驱动。尽管其最后稳定提交在 2016 年，且不支持 MongoDB 4.0+ 的新特性（如事务、会话、更细粒度的错误分类等），但它在当时广泛用于中小型项目。

然而，如今已强烈不建议新项目继续使用 mgo。自 2018 年起，MongoDB 官方正式发布并开源了全新一代 Go 驱动：mongo-go-driver，模块化设计（mongo、bson、options 等），完全兼容 MongoDB 4.0–7.x，原生支持：

基于上下文（context.Context）的超时与取消控制
ACID 事务（多文档、跨集合）
连接池自动管理与负载均衡（支持分片集群）
丰富的 CRUD 操作接口与灵活的选项配置

✅ 安装方式（Go 1.16+，推荐使用 go.mod）：

go get go.mongodb.org/mongo-driver/mongo
go get go.mongodb.org/mongo-driver/bson

✅ 快速连接示例：

趣问问AI

一款面向日常问答和中文内容创作的AI工具，可用于智能对话、文章写作和信息整理等常见人工智能任务。

下载

package main

import (
    "context"
    "log"
    "time"
    "go.mongodb.org/mongo-driver/mongo"
    "go.mongodb.org/mongo-driver/mongo/options"
)

func main() {
    ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
    defer cancel()

    client, err := mongo.Connect(ctx, options.Client().ApplyURI("mongodb://localhost:27017"))
    if err != nil {
        log.Fatal(err)
    }
    defer func() {
        if err = client.Disconnect(ctx); err != nil {
            log.Fatal(err)
        }
    }()

    db := client.Database("testdb")
    collection := db.Collection("users")
    log.Println("Connected to MongoDB successfully!")
}

⚠️ 注意事项：