函数中module.exports参数无法被IntelliSense识别的解决问询

我编写了index.js和commandExample.js两个文件，后者会在非机器人用户发送消息时执行。index.js代码如下：

const { Client, IntentsBitField, Events} = require("discord.js");
const {token} = require("./config.json");
const cmd = require("./commandExample.js");

const client = new Client({
  intents: [
    IntentsBitField.Flags.GuildMembers,
    IntentsBitField.Flags.GuildMessages,
    IntentsBitField.Flags.Guilds,
    IntentsBitField.Flags.MessageContent
  ]
});
var prefix = ",";

client.on(Events.MessageCreate, (message) => {
    // 检查消息发送者是否为机器人
    if (message.author.bot) return;
    // 将message参数传入外部模块执行
    cmd(message);
})

client.login(token);

问题在于：把Message对象传入commandExample.js导出的函数后，IntelliSense无法自动补全该对象的属性和方法。在index.js的事件监听器中输入message.时，能正常显示所有相关方法和属性提示，但在commandExample.js的函数里输入接收的参数（比如msg.）时毫无提示。另外，在cmd函数内创建事件监听器并不实用，因为监听器存在数量上限，手动设置上限有时会导致机器人崩溃或运行极慢。

实用解决方法 #

方法1：用JSDoc标注参数类型（纯JS项目首选）

在commandExample.js中，通过JSDoc明确指定参数的类型为Discord.js的Message对象，编辑器就能识别并提供补全：

/**
 * @param {import('discord.js').Message} msg
 */
module.exports = function(msg) {
  // 此时输入msg.即可看到完整的属性和方法提示
  console.log(msg.content);
};

方法2：迁移到TypeScript（适合长期维护的项目）

如果项目可以切换到TypeScript，直接为参数定义类型即可完美解决：

import { Message } from 'discord.js';

export default function(msg: Message) {
  // IntelliSense自动补全正常工作
}

方法3：导出类型引用（纯JS备选方案）

在index.js中导出Message类型的占位，然后在commandExample.js中引用：
在index.js添加一行：

/** @type {import('discord.js').Message} */
module.exports.MessageType = null;

在commandExample.js中使用：

/**
 * @param {typeof import('./index.js').MessageType} msg
 */
module.exports = function(msg) {
  // 补全功能生效
};

总结 #

最简便有效的方案是使用JSDoc标注参数类型，无需切换语言，仅需几行注释就能让IntelliSense正常工作。

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