npm安装包无报错但无法使用的问题求助

问题详情 #

执行npm i cors等依赖安装命令时无报错，输出如下：

npm i cors

up to date, audited 852 packages in 6s

found 0 vulnerabilities

项目根目录的package.json中已正确显示依赖：

{
  "name": "deneme",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "dependencies": {
    "cors": "*",
    "express": "*",
    "nodemon": "*"
  }
}

但运行以下代码时：

const express = require('express')

const app = express()

app.listen(4000 , () => {
    console.log('hello');
})

出现MODULE_NOT_FOUND错误：

node deneme.js
node:internal/modules/cjs/loader:1145
  throw err;
  ^

Error: Cannot find module 'express'
Require stack:
- C:\***\****\Desktop\deneme\deneme.js
    at Module._resolveFilename (node:internal/modules/cjs/loader:1142:15)
    at Module._load (node:internal/modules/cjs/loader:983:27)
    at Module.require (node:internal/modules/cjs/loader:1230:19)
    at require (node:internal/modules/helpers:179:18)
    at Object.<anonymous> (C:\***\****\Desktop\deneme\deneme.js:1:17)
    at Module._compile (node:internal/modules/cjs/loader:1368:14)
    at Module._extensions..js (node:internal/modules/cjs/loader:1426:10)
    at Module.load (node:internal/modules/cjs/loader:1205:32)
    at Module._load (node:internal/modules/cjs/loader:1021:12)
    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:142:12) {
  code: 'MODULE_NOT_FOUND',
}

已尝试的操作：

• 更换不同npm版本
• 检查PATH变量
• 以管理员身份运行命令
• 清除npm缓存（操作失败）

可能的原因及修复方法 #

1. 检查node_modules目录完整性 #

• 查看项目根目录下是否存在node_modules文件夹：
  • 如果不存在，删除package-lock.json后重新执行npm install
  • 如果存在但模块缺失，直接删除整个node_modules和锁文件，再重新安装：

    # Windows系统
    rmdir /s /q node_modules && del package-lock.json
    # macOS/Linux系统
    rm -rf node_modules package-lock.json
    npm install
    

2. 确认Node.js与npm路径一致 #

• 执行命令检查路径是否匹配：

  # Windows系统
  where node && where npm
  # macOS/Linux系统
  which node && which npm
  

• 如果路径来自不同的Node.js安装目录，用nvm（Node版本管理器）切换到对应版本后，重新安装依赖。

3. 验证本地依赖安装状态 #

• 执行npm list express查看本地是否已安装该模块，若输出empty说明依赖未正确安装，需重新执行npm install express。
• 确保安装时未加-g参数（全局安装的模块无法被本地项目直接require）。

4. 强制清除npm缓存 #

• 执行强制清除缓存命令，再重新安装：

  npm cache clean --force
  npm install
  

5. 排查文件权限问题 #

• Windows系统下，检查项目目录是否被设置为只读，或当前用户是否有读写权限；可尝试将项目移动到非系统盘（如D盘）后重新操作。

6. 解决包管理器冲突 #

• 如果之前使用过pnpm、yarn等其他包管理器，删除所有锁文件（package-lock.json、yarn.lock、pnpm-lock.yaml）和node_modules，再用npm重新安装依赖。

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