如何在MongoDB中创建、更新和删除文档

MongoDB中的文档是数据存储的基本单位，结构类似JSON对象，支持嵌套和数组类型，理解文档操作是上手MongoDB的第一步。

一、创建文档

MongoDB提供了多种创建文档的方式，最常用的是insertOne和insertMany方法，分别对应插入单条和多条文档。

1. 插入单条文档

使用insertOne方法可以向指定集合中插入一条文档，插入成功后会返回插入的文档ID。

// 连接MongoDB数据库，假设已建立连接，数据库名为test，集合名为users
const { MongoClient } = require('mongodb');
const uri = "mongodb://127.0.0.1:27017";
const client = new MongoClient(uri);

async function insertSingleDoc() {
  try {
    await client.connect();
    const database = client.db('test');
    const collection = database.collection('users');
    // 定义要插入的文档
    const doc = {
      name: "张三",
      age: 25,
      hobbies: ["读书", "跑步"],
      address: {
        city: "北京",
        district: "海淀区"
      }
    };
    // 执行插入操作
    const result = await collection.insertOne(doc);
    console.log(`成功插入单条文档，插入ID: ${result.insertedId}`);
  } finally {
    await client.close();
  }
}

insertSingleDoc().catch(console.error);

2. 插入多条文档

如果需要批量插入文档，可以使用insertMany方法，传入文档数组即可。

async function insertMultiDoc() {
  try {
    await client.connect();
    const database = client.db('test');
    const collection = database.collection('users');
    // 定义要插入的多条文档
    const docs = [
      { name: "李四", age: 22, hobbies: ["打游戏"] },
      { name: "王五", age: 28, hobbies: ["旅游", "摄影"] },
      { name: "赵六", age: 24, hobbies: ["烹饪"] }
    ];
    const result = await collection.insertMany(docs);
    console.log(`成功插入${result.insertedCount}条文档`);
  } finally {
    await client.close();
  }
}

insertMultiDoc().catch(console.error);

二、更新文档

更新文档需要使用updateOne、updateMany或者replaceOne方法，通常需要指定筛选条件和更新内容，更新内容要使用MongoDB的更新操作符。

1. 更新单条文档

updateOne只会更新匹配筛选条件的第一条文档，下面的示例给匹配的文档添加新字段并更新已有字段。

async function updateSingleDoc() {
  try {
    await client.connect();
    const database = client.db('test');
    const collection = database.collection('users');
    // 筛选条件：name为张三的文档
    const filter = { name: "张三" };
    // 更新操作：年龄加1，添加email字段
    const updateDoc = {
      $inc: { age: 1 },
      $set: { email: "zhangsan@ipipp.com" }
    };
    const result = await collection.updateOne(filter, updateDoc);
    console.log(`匹配到${result.matchedCount}条文档，修改了${result.modifiedCount}条文档`);
  } finally {
    await client.close();
  }
}

updateSingleDoc().catch(console.error);

2. 更新多条文档

如果需要更新所有匹配条件的文档，使用updateMany方法即可，用法和updateOne类似。

async function updateMultiDoc() {
  try {
    await client.connect();
    const database = client.db('test');
    const collection = database.collection('users');
    // 筛选条件：年龄小于25岁的文档
    const filter = { age: { $lt: 25 } };
    // 更新操作：给所有匹配文档的hobbies数组添加"学习"元素
    const updateDoc = {
      $push: { hobbies: "学习" }
    };
    const result = await collection.updateMany(filter, updateDoc);
    console.log(`匹配到${result.matchedCount}条文档，修改了${result.modifiedCount}条文档`);
  } finally {
    await client.close();
  }
}

updateMultiDoc().catch(console.error);

3. 替换文档

replaceOne会用新的文档完全替换匹配到的第一条文档，注意替换后的文档不会保留原文档的未提及字段。

async function replaceDoc() {
  try {
    await client.connect();
    const database = client.db('test');
    const collection = database.collection('users');
    const filter = { name: "李四" };
    // 替换后的新文档，原文档其他字段会被覆盖
    const newDoc = {
      name: "李四",
      age: 23,
      grade: "A"
    };
    const result = await collection.replaceOne(filter, newDoc);
    console.log(`匹配到${result.matchedCount}条文档，替换了${result.modifiedCount}条文档`);
  } finally {
    await client.close();
  }
}

replaceDoc().catch(console.error);

三、删除文档

删除文档可以使用deleteOne和deleteMany方法，分别对应删除单条和批量删除，删除操作需要谨慎使用，避免误删数据。

1. 删除单条文档

deleteOne会删除匹配筛选条件的第一条文档。

async function deleteSingleDoc() {
  try {
    await client.connect();
    const database = client.db('test');
    const collection = database.collection('users');
    // 筛选条件：name为赵六的文档
    const filter = { name: "赵六" };
    const result = await collection.deleteOne(filter);
    console.log(`成功删除了${result.deletedCount}条文档`);
  } finally {
    await client.close();
  }
}

deleteSingleDoc().catch(console.error);

2. 删除多条文档

deleteMany会删除所有匹配筛选条件的文档，如果传入空对象{}则会删除集合中的所有文档，操作前建议先确认筛选条件。

async function deleteMultiDoc() {
  try {
    await client.connect();
    const database = client.db('test');
    const collection = database.collection('users');
    // 筛选条件：年龄大于等于28岁的文档
    const filter = { age: { $gte: 28 } };
    const result = await collection.deleteMany(filter);
    console.log(`成功删除了${result.deletedCount}条文档`);
  } finally {
    await client.close();
  }
}

deleteMultiDoc().catch(console.error);

注意事项

• 执行删除操作前，建议先使用对应的筛选条件执行查询操作，确认要删除的文档范围，避免误删重要数据。
• 更新文档时如果使用$set操作符，只会修改指定的字段，不会影响其他字段；如果直接传入新对象不使用更新操作符，相当于执行替换操作，会丢失原文档的其他字段。
• 插入文档时如果没有指定_id字段，MongoDB会自动生成唯一的ObjectId作为文档标识，不建议手动指定_id除非有特殊业务需求。

MongoDB文档操作create_documentupdate_documentdelete_document修改时间：2026-05-30 20:41:51