VS Code插件开发中，智能提示正常但运行时报错“Cannot find module”？

VS Code 插件开发中，正确导入 JavaScript 模块至关重要。本文分析并解决一个常见问题：使用绝对路径导入模块时，VS Code 智能提示正常，但运行时却报错“Cannot find module”。

问题现象： 开发者在 VS Code 插件开发中，使用绝对路径（例如 @/util/testutil.js）导入 JS 模块。VS Code 提供了正确的代码提示，但在运行或调试时，却出现 Cannot find module '@/util/testutil.js' 错误。

已知配置： jsconfig.json 文件配置如下：

{
  "compilerOptions": {
    "module": "node16",
    "target": "es2022",
    "checkJs": true,
    "lib": ["es2022"],
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"]
    }
  },
  "exclude": ["node_modules"]
}

待导入模块 (src/util/testutil.js) 代码：

let test = {
  test123() {},
  test567() {}
};
module.exports = { test };

导入语句：const testutil = require('@/util/testutil.js');

问题根源及解决方案：

jsconfig.json 文件中的 paths 配置只对 VS Code 的代码提示有效，不影响 Node.js 的模块解析机制。paths 告诉 VS Code 如何将 @/util/testutil.js 映射到 ./src/util/testutil.js，从而实现代码补全和跳转。然而，Node.js 的 require 函数在运行时并不会读取 jsconfig.json 中的 paths 配置。

解决方法是：在构建流程中配置路径别名。 这需要根据你使用的构建工具（Webpack, Parcel, Rollup 等）进行相应的配置。 例如，使用 Webpack，可以在 webpack.config.js 中添加如下配置：

const path = require('path');

module.exports = {
  // ... other webpack configurations
  resolve: {
    alias: {
      '@': path.resolve(__dirname, 'src')
    }
  }
};

这样，Webpack 在打包过程中就会将 @ 替换成 src 的绝对路径，从而正确解析模块。 其他构建工具的配置方法类似，请参考你所用工具的官方文档。 关键在于让你的构建工具理解并使用 @ 这样的路径别名。