Discord JS 独立module.exports文件中VSCode代码补全/提示失效问题

以下方案按生效优先级排序，可依次尝试：

1. JSDoc显式标注参数类型（最稳定，零额外配置） #

VSCode对CommonJS规范的跨文件类型推断能力有限，独立导出的事件文件无法自动识别从主文件传入的Discord.js实例类型，直接通过JSDoc给执行函数的参数标记对应类型即可恢复补全。
以messageCreate.js为例，原无补全的写法：

module.exports = {
  name: 'messageCreate',
  execute(message) {
    // 此处输入message. 无补全提示
  }
}

添加类型标注后的写法：

// 仅引入类型做标注，不会额外影响运行逻辑
const { Message } = require('discord.js');

module.exports = {
  name: 'messageCreate',
  /**
   * 消息创建事件执行逻辑
   * @param {Message} message 消息实例
   */
  execute(message) {
    // 此处输入message. 即可弹出完整的属性、方法补全
  }
}

如果执行函数同时传入client实例，补充对应类型标注即可：

const { Client, Message } = require('discord.js');

module.exports = {
  name: 'messageCreate',
  /**
   * @param {Client} client 机器人客户端实例
   * @param {Message} message 消息实例
   */
  execute(client, message) {
    // client、message均支持完整代码补全
  }
}

2. 新增jsconfig.json全局类型配置 #

在项目根目录新建jsconfig.json文件，写入以下配置，让VSCode的JS语言服务全局识别项目依赖、加载discord.js的官方类型定义文件，从全局层面解决跨文件类型丢失问题：

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "CommonJS",
    "checkJs": false,
    "types": ["node", "discord.js"]
  },
  "include": ["./**/*.js"],
  "exclude": ["node_modules"]
}

保存文件后按Ctrl+Shift+P（Mac为Cmd+Shift+P）调出命令面板，执行Developer: Reload Window重载窗口即可生效。

3. 排查VSCode基础设置问题 #

如果以上方案均未生效，逐项检查以下设置：

• 确认内置的JavaScript and TypeScript Language Features扩展未被禁用，这是VSCode提供JS代码补全的核心依赖
• 打开设置搜索javascript.suggest.enabled，确认全局、当前工作区的该选项均为开启状态
• 检查工作区.vscode/settings.json文件，确认事件文件所在目录未被加入files.exclude或search.exclude列表，避免被语言服务忽略扫描

提示：JSDoc标注方案是兼容性最高的方案，不受项目结构、VSCode版本影响，长期维护Discord.js项目建议优先使用该写法。

内容的提问来源于stack exchange，提问作者CalickLive