TypeScript与Node.js模块导入差异及Discord.js机器人命令处理器动态导入报错问题

我之前也遇到过类似的问题，结合你的代码和配置来看，主要是路径不匹配和模块导出/导入的适配问题导致的，下面一步步给你解决：

一、核心问题分析 #

1. 路径错误：你写的./src/commands/${file}是针对源码目录的，但TypeScript编译后会生成js文件（配置outDir后会输出到指定目录），运行时执行的是编译后的文件，此时相对路径指向的位置根本不存在对应的模块。
2. 模块导出适配：你用了export default，但你的tsconfig设置的是commonjs模块系统，动态导入后的模块对象会把默认导出放在.default属性里，直接访问command.name会拿不到值，甚至因为路径问题先触发找不到模块的报错。

二、分步解决 #

1. 修正tsconfig.json配置 #

首先完善编译配置，确保输出目录清晰，模块解析正确：

{
  "compilerOptions": {
    "target": "es2020", // Discord.js依赖ES2017+，选更高版本更兼容
    "module": "commonjs",
    "rootDir": "./src",
    "outDir": "./dist", // 新增：指定编译后的文件输出到dist目录
    "esModuleInterop": true,
    "forceConsistentCasingInFileNames": true,
    "strict": true,
    "noImplicitAny": false,
    "skipLibCheck": true,
    "moduleResolution": "node", // 明确使用Node.js的模块解析规则
    "allowSyntheticDefaultImports": true // 兼容默认导入非ES模块
  },
  "include": ["src"]
}

2. 重写命令导入逻辑 #

用path模块和__dirname来确保路径绝对正确，同时处理默认导出的问题：

import fs from 'fs';
import path from 'path';
import { Collection, Interaction } from 'discord.js';

// 定义命令类型，提升TypeScript类型安全性
interface Command {
  name: string;
  description: string;
  execute: (options: { interaction: Interaction }) => Promise<void>;
}

const commands = new Collection<string, Command>();

// 获取编译后的命令文件目录（__dirname是当前执行文件的绝对路径）
const commandsDir = path.resolve(__dirname, './commands');
// 筛选编译后的.js文件（TS编译后会转成JS）
const commandFiles = fs.readdirSync(commandsDir).filter(file => file.endsWith('.js'));

for (const file of commandFiles) {
  const filePath = path.join(commandsDir, file);
  import(filePath)
    .then(module => {
      // 取默认导出的命令对象
      const command = module.default;
      // 校验命令结构是否完整
      if ('name' in command && 'execute' in command) {
        commands.set(command.name, command);
      } else {
        console.warn(`[警告] 命令文件${filePath}缺少必填的name或execute属性`);
      }
    })
    .catch(err => {
      console.error(`加载命令${filePath}失败：`, err);
    });
}

3. 开发/生产环境的路径兼容（可选） #

如果用ts-node直接运行TS文件开发，__dirname指向的是src目录，此时可以通过环境变量判断路径：

const isDevelopment = process.env.NODE_ENV === 'development';
const commandsDir = isDevelopment 
  ? path.resolve(__dirname, './commands') // 开发时直接读src下的TS文件
  : path.resolve(__dirname, './commands'); // 生产时读dist下的JS文件

// 开发时筛选.ts文件，生产时筛选.js文件
const commandFiles = fs.readdirSync(commandsDir).filter(file => 
  isDevelopment ? file.endsWith('.ts') : file.endsWith('.js')
);

三、验证步骤 #

1. 执行tsc编译代码，确认dist目录下生成了commands文件夹和对应的JS文件。
2. 运行编译后的主文件（比如node dist/index.js），此时应该能正确加载所有命令，不会再出现找不到模块的报错。

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