Node.js MongoDB驱动Mongoose基础使用指南

作者：岩茶时间：2026-10-29 22:40:01浏览：434

本文介绍如何在Node.js环境中使用Mongoose驱动操作MongoDB数据库。内容涵盖安装配置、Schema定义、数据类型、模型创建以及增删改查（CRUD）的具体实现方法，帮助开发者简化数据库交互逻辑。

Mongoose简介与安装

借助Mongoose库，开发者可以更便捷地操作MongoDB数据库，从而避免编写繁琐的业务逻辑代码。

安装


npm install mongoose

初始化使用在正式使用Mongoose之前，需要确保环境中已安装Node.js和MongoDB。本文不赘述这两者的具体安装步骤。


 var mongoose = require("mongoose");
 var Schema = mongoose.Schema;
 var db = mongoose.connection;
 mongoose.connect('mongodb://localhost/animal');
 db.on('error', console.error);
 db.once('open', function() {
  //这里建立模式和模型
 }

Schema与Model基础

快速入门在Mongoose框架中，所有数据均基于模式（Schema）进行定义。每个Schema映射到MongoDB的一个集合（Collection），并规定该集合中文档的结构。


 //这里建立一个动物的模式，所有动物都拥有这个模式下的所有属性
 var animalSchema = new Schema({
  name: String,
  age: Number,
 });

模型（Model）是根据Schema定义的构造函数，其实例提供了丰富的操作方法。所有文档的创建与检索工作均由模型负责处理。


 var animalMode = db.model('Animal', animalSchema);

模型的实例本质上对应数据库中的文档，开发者可以轻松地对这些文档进行创建和修改操作。


 var cat = new animalMode({
  name: 'catName',
  age: '7', //这里依然使用字符串，mongoose会自动转换类型
  });

 cat.save(function(err, thor) {
  if (err) return console.log(err);
  console.log(thor);
 });
 //或者可以使用create
 //cat.create(function(err, thor) {
 // if (err) return console.log(err);
 // console.log(thor);
 //});

 //执行查找
 animalMode.find(function(err, people){
  if(err) console.log(err);
  console.log(people);
 });
 //查找符合条件数据
 animalMode.findOne({title: 'catName'}, function(err, cat){
  if(err) console.log(err);
  console.log(cat);
 });

Schema数据类型与自定义方法

Schema 数据类型

以下是Mongoose支持的所有数据类型，其中包括Mongoose自定义的特殊类型。

String
Number
Date
Buffer
Boolean
Mixed
ObjectId
Array

每种数据类型的使用


 var animalMode = mongoose.model('Animal', schema);

 var cat = new animalMode;
 cat.name = 'Statue of Liberty'    //String
 cat.age = '7';        //Number
 cat.updated = new Date;      //Date
 cat.binary = new Buffer(0);     //Buffer
 cat.living = false;       //Boolean
 cat.mixed = { any: { thing: 'i want' } }; //Mixed    
 cat._someId = new mongoose.Types.ObjectId; //ObjectId
 cat.ofString.push("strings!");    //Array

Mixed是Mongoose自定义的一种混合类型，由于未定义具体结构，可以使用对象字面量{}进行赋值。以下两种定义方式在功能上是等价的。


 var animalSchema = new Schema({any: {}});
 var animalSchema = new Schema({any: {Schema.Types.Mixed}});

自定义方法

可以为Schema实例绑定实例方法。


 var animalSchema = new Schema({
  name: String,
  age: Number,
 });

 animalSchema.methods.findSimilarTypes = function (cb) {
  return this.model('Animal').find({ name: this.name }, cb);
 }

 var animalMode = db.model('Animal', animalSchema);

 cat.findSimilarTypes(function(err, cat){
  if(err) console.log(err);
  console.log(cat);
 });

也可以为Schema添加静态方法。


 animalSchema.statics.findByName = function (name, cb) {
  return this.find({ name: new RegExp(name, 'i') }, cb);
 }
 var animalMode = db.model('Animal', animalSchema);

 animalMode.findByName('catName', function (err, animals) {
  console.log(animals);
 });

索引设置

索引

可以为MongoDB数据建立索引。MongoDB支持二级索引，为了提高数据查找和定位效率，建立复合索引是必要的。


 var animalSchema = new Schema({
  name: String,
  age: Number,
  tags: { age: [String], index: true } // field level
 });

 animalSchema.index({ name: 1, age: -1 }); // schema level

然而，索引的建立可能导致显著的性能影响，建议在生产环境中禁用。可以通过将模式下的自动索引设置为false来禁止自动创建索引。


 animalSchema.set('autoIndex', false);
 // or
 new Schema({..}, { autoIndex: false });

Model CRUD操作

Model C（Create）


 cat.save(function(err, thor) {
  if (err) return console.log(err);
  console.log(thor);
 });
 //或者可以使用create
 cat.create(function(err, thor) {
  if (err) return console.log(err);
  console.log(thor);
 });

R（Read）


//find
animalMode.find(function(err, cat){
 if (err) console.log(err);
 console.log(cat);
})

//findOne
animalMode.findOne({name: 'catName'}, function(err, cat){
 if (err) console.log(err);
 console.log(cat);
})

//findByID
//与 findOne 相同，但它接收文档的 _id 作为参数，返回单个文档。_id //可以是字符串或 ObjectId 对象。
animalMode.findById(id, function(err, adventure){
 if (err) consoel.log(err);
 console.log(adventure);
});

//where
//查询数据类型是字符串时，可支持正则
animalMode.where('age', '2').exec(function(err, cat){
 if (err) console.log(err);
 console.log(cat);
});

animalMode
 .where('age').gte(1).lte(10)
 .where('name', 'catName')
 .exec(function(err, cat){
  if (err) console.log(err);
  console.log(cat);
 });

U（Update）官方文档提供的更新函数为Model.update。

Model.update(conditions, doc, [options], [callback])

conditions 更新条件
doc 更新内容
option 更新选项
safe (boolean) 安全模式，默认选项，值为true
upsert (boolean) 条件不匹配时是否创建新文档，默认值为false
multi (boolean) 是否更新多个文件，默认值为false
strict (boolean) 严格模式，只更新一条数据
overwrite (boolean) 覆盖数据，默认为false
callback
err 更新数据出错时返回值
numberAffected （笔者暂时不清楚）
rawResponse 受影响的行数


animalMode.update({name: 'catName'}, {age: '6'}, {multi : true}, function(err, numberAffected, raw){
 if (err) return console.log(err);
 console.log('The number of updated documents was %d', numberAffected);
 console.log('The raw response from Mongo was ', raw);
});

D（Delete）


animalMode.remove({age: 6}, function(err){
 if (err) console.log(err);
})

其它 //返回文档数


animalMode.count({age: 2}, function(err, cat){
 if (err) console.log(err);
 console.log(cat);
})

作者最新文章

怎么在本地运行JavaScript脚本：Node.js下载安装与环境配置教程

2026-11-05 09:02:33

JavaScript开发环境怎么搭建：Node.js安装与VS Code配置指南

2026-11-03 23:36:59

JavaScript零基础入门：环境搭建与第一个Hello World

2026-11-03 23:34:09

NW.js 是什么：基于 Chromium 和 Node.js 的桌面应用框架

2026-11-03 15:14:00

nvm、n 和官方安装包：哪种 Node.js 升级方式更适合你

2026-11-03 14:54:28