
本文教你用 discord.js v14 实现机器人对预设关键词数组(如 "hello"、"hi"、"hey")的精准响应,通过 `message.content.tolowercase().includes()` 安全匹配,避免误触发或完全无响应问题。
要让 Discord 机器人响应一组关键词(而非单一固定消息),核心在于:将用户输入与关键词数组进行大小写不敏感的精确匹配,而非模糊包含(如 "hello world".includes("hello") 是 true,但 "helloworld" 也会被误判)。你当前遇到“响应所有消息或不响应”的问题,通常源于以下常见错误:
- ❌ 错误使用 includes() 判断整个消息是否“包含”关键词(导致 "ahello" 也被匹配);
- ❌ 忘记转为小写,导致 "Hello" ≠ "hello";
- ❌ 未过滤机器人自身消息,引发无限循环;
- ❌ 使用已弃用的 message 事件(v14+ 必须用 messageCreate)。
✅ 正确做法是:完全匹配 + 大小写归一 + 排除 bot 自身消息。以下是推荐实现:
const { Client, IntentsBitField } = require('discord.js');
const client = new Client({
intents: [
IntentsBitField.Flags.Guilds,
IntentsBitField.Flags.GuildMessages,
IntentsBitField.Flags.MessageContent // ⚠️ 必须启用!否则 message.content 为 undefined
]
});
// ✅ 预设关键词数组(支持中英文、emoji 等)
const triggerKeywords = ['hello', 'hi', 'hey', '你好', '哈喽', '?'];
client.once('ready', () => {
console.log(`✅ ${client.user.tag} 已上线,监听关键词:${triggerKeywords.join(', ')}`);
});
client.on('messageCreate', message => {
// ? 过滤:跳过机器人自己发的消息、系统消息、无内容消息
if (message.author.bot || !message.content.trim()) return;
// ? 精确匹配:将消息转为小写后,检查是否 *完全等于* 数组中任一关键词
const userMsg = message.content.trim().toLowerCase();
if (triggerKeywords.some(keyword => keyword.toLowerCase() === userMsg)) {
message.reply('? Hello! I\'m your friendly Discord bot. How can I help you today?');
}
});
// ? 替换为你的 Bot Token(从 Discord Developer Portal 获取)
client.login('YOUR_BOT_TOKEN_HERE');? 关键说明:
- message.content.trim().toLowerCase() 消除首尾空格并统一大小写,确保 ' Hi ' → 'hi';
- triggerKeywords.some(...) 实现「只要匹配任意一个就触发」,语义清晰且性能优于 includes()(后者仅适用于字符串包含判断);
- IntentsBitField.Flags.MessageContent 是 v14+ 强制要求——若缺失,message.content 始终为空字符串,导致永远不匹配;
- message.reply() 自动@发送者并保持上下文,比 message.channel.send() 更友好。
⚠️ 注意事项:
- 不要使用 var 或 let 替换 const 来“修复语法”——JavaScript 中 const 声明不可重新赋值,但对象/数组内容仍可修改,此处无需改动;
- 避免用 indexOf !== -1 替代 some():可读性差,且逻辑等价但更易出错;
- 如需支持“部分匹配”(如用户说 “hi there” 也响应),请改用正则:/^(hi|hello|hey)/i.test(message.content),但需谨慎防止过度触发。
掌握这一模式后,你可轻松扩展为多关键词-多回复映射、命令前缀解析(如 !help)、甚至结合数据库动态加载关键词列表。机器人交互的第一步,就是让每一次回应都准确而可靠。










