Node.js全局NODE_PATH错误：无法找到已安装模块求助

可能的解决方案： #

1. 修正TypeScript的模块解析配置 #

错误路径指向Microsoft的TypeScript全局目录，大概率是tsconfig.json的模块解析配置出了问题。打开项目根目录的tsconfig.json，调整以下配置：

{
  "compilerOptions": {
    "moduleResolution": "node", // 改用Node.js的模块解析逻辑
    "baseUrl": "./", // 模块查找基准设为项目根目录
    "paths": {} // 清空可能错误的路径映射，避免强制指向TypeScript全局目录
  }
}

保存后重新编译项目。

2. 清除TypeScript缓存 #

TypeScript的编译缓存可能导致路径缓存未更新，执行以下操作：

• 删除项目根目录下的.tsbuildinfo文件（如果存在）
• 运行全局缓存清理命令（TypeScript 4.8+支持）：

  tsc --clearCache
  

3. 确保本地依赖正确安装 #

即使全局装了模块，项目本地也需要正确安装依赖：

npm install express --save

安装完成后检查项目根目录的node_modules文件夹下是否存在express，同时确认package.json的dependencies中包含express。

4. 链接全局模块到本地（可选） #

如果依赖全局安装的模块，需要将其链接到项目本地：

npm link express

但更推荐直接本地安装依赖，减少全局环境带来的冲突。

5. 验证环境变量生效 #

修改NODE_PATH后，确保终端已重启，运行以下命令查看变量是否正确设置（Windows环境）：

echo %NODE_PATH%

确认输出为user/AppData/Roaming/npm/node_modules，如果未生效，需要重新配置环境变量并重启系统。

6. 使用本地TypeScript编译 #

如果全局TypeScript版本存在路径问题，在项目本地安装TypeScript并使用本地命令编译：

npm install typescript --save-dev
npx tsc

这样会使用项目本地的TypeScript环境，避免全局环境的干扰。

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