Node.js依赖安装后node_modules文件夹不显示问题求助

问题情况 #

执行npm install、npm install next等命令后，控制台显示安装成功，但项目根目录始终找不到node_modules文件夹；package.json文件中已正常列出相关依赖。

已尝试的无效方案 #

• 删除Local和Roaming目录下的npm相关缓存文件夹
• 重装Node.js
• 参考Stack Overflow相关方案，均未解决问题

项目package.json内容 #

{
  "name": "ebay-clone",
  "version": "0.1.0",
  "private": true,
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start",
    "lint": "next lint"
  },
  "dependencies": {
    "react": "^18",
    "react-dom": "^18",
    "next": "14.0.4"
  },
  "devDependencies": {
    "autoprefixer": "^10.0.1",
    "postcss": "^8",
    "tailwindcss": "^3.3.0"
  },
  "main": "next.config.js",
  "author": "",
  "license": "ISC"
}

排查与解决步骤 #

1. 确认终端当前工作目录 #

执行pwd（Mac/Linux）或cd（Windows命令提示符），确保终端当前所在目录就是package.json所在的项目根目录——很多时候是终端开错目录，导致依赖被安装到了其他位置。

2. 检查npm路径配置 #

• 执行以下命令查看npm的全局路径和缓存路径：

  npm config get prefix
  npm config get cache
  

• 若路径异常（比如指向非预期的文件夹），执行以下命令恢复默认配置：

  npm config delete prefix
  npm config delete cache
  

• 之后重新执行npm install

3. 强制清理缓存并重装 #

• 强制清理npm缓存：

  npm cache clean --force
  

• 删除项目目录下的package-lock.json文件（如果存在）
• 跳过缓存重新安装：

  npm install --no-cache
  

4. 检查npm版本兼容性 #

Next.js 14.0.4建议搭配npm 9.x或10.x版本，执行npm -v查看当前版本：

• 若版本不符，升级/降级到稳定版本：

  npm install -g npm@9.8.1
  

5. 检查目录权限（Mac/Linux用户） #

如果项目目录是用root权限创建的，普通用户可能没有写入权限，执行以下命令修改目录权限：

sudo chown -R $USER:$USER ./

修改后再执行npm install

6. 排查环境变量干扰 #

查看是否存在NPM_CONFIG_PREFIX环境变量导致安装路径偏移：

• 临时取消该变量后重新安装：

  unset NPM_CONFIG_PREFIX && npm install
  

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