重构项目结构后出现Could not resolve "vscode"编译错误

可能的原因及修复步骤 #

• 检查路径别名配置是否干扰vscode模块解析
  如果你在tsconfig.json中配置了paths字段，确保没有误将"vscode"加入别名映射，也不要让自定义别名规则覆盖默认的模块解析逻辑。比如避免这类错误配置：

  // 错误示例：不要把vscode纳入自定义路径别名
  "paths": {
    "@/*": ["./src/*"],
    "vscode": ["./some/custom/path"]
  }
  

  正确的paths应仅包含你的业务代码别名，保留vscode模块的默认解析路径。

• 确认编译工具的模块解析配置
  若使用webpack、rollup等打包工具，需确保别名插件（如tsconfig-paths-webpack-plugin）仅处理自定义路径，同时在resolve配置中明确包含node_modules目录。以webpack为例：

  const TsconfigPathsPlugin = require('tsconfig-paths-webpack-plugin');
  
  module.exports = {
    resolve: {
      modules: ['node_modules', path.resolve(__dirname, 'src')],
      plugins: [new TsconfigPathsPlugin({ configFile: './tsconfig.json' })]
    }
  };
  

• 重新确认vscode类型依赖
  即使删除过node_modules，仍需检查package.json中@types/vscode的存在性及版本匹配度。执行命令重新安装：

  npm install @types/vscode --save-dev
  

  同时保证package.json的engines.vscode字段与@types/vscode版本对应，比如：

  "engines": {
    "vscode": "^1.80.0"
  },
  "devDependencies": {
    "@types/vscode": "^1.80.0"
  }
  

• 验证tsconfig的模块解析模式
  在tsconfig.json中设置正确的moduleResolution值，让TypeScript遵循Node.js或打包工具的模块解析规则：

  "moduleResolution": "node",
  

• 清理编译缓存文件
  除了node_modules，还需删除编译工具生成的缓存目录或文件，比如webpack的.webpack文件夹、TypeScript的tsconfig.tsbuildinfo，再重新编译：

  rm -rf .webpack tsconfig.tsbuildinfo
  npm run compile
  

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