$toLower（转小写）

最后更新：2026-10-09

$toLower（转小写）

$toLower 将字符串转为小写，是文本规范化的基础操作符。常用于统一存储格式、构造不区分大小写的查询键（配合索引）或清洗用户输入。只接受字符串，其他类型会报错，可先 $toString 转换。它与 $toUpper 互为反操作。注意中文等没有大小写概念的字符会原样返回。对中文等无大小写的字符，转换后内容保持不变。

📝 语法

{ $toLower: <字符串表达式> }

⚙️ 参数

返回值：转小写后的字符串。

▶ 示例

请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：

// $toLower：邮箱统一为小写
 db.users.aggregate([
  { $project: { emailLower: { $toLower: '$email' } } }
])

运行结果：

{ "_id": 1, "emailLower": "alice@example.com" }
{ "_id": 2, "emailLower": "bob@example.com" }

📌 注意事项

• 只接受字符串，数字、日期需先转换
• 与 $toUpper 互为反操作
• 中文等无大小写概念的字符原样返回

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。

关于我们