React及Vite项目中npm install无法安装node_modules问题求助

问题现象 #

• 执行npm install后，项目目录下无node_modules生成，未安装任何依赖包
• 尝试安装react-router时，控制台有执行反馈，但依赖既未写入package.json，也未出现在项目中
• 删除node_modules后重新执行npm install，控制台提示up to date in 112ms，但依旧无任何安装动作
• 新建多个Create React App（CRA）及Vite项目，问题均复现

示例项目信息 #

控制台输出

username@my-computer MINGW64 ~/Desktop/Pp/Portafolio a ver si funciona/portafolioch -mich (main)
$ npm install
up to date in 112ms
username@my-computer MINGW64 ~/Desktop/Portafolio a ver si funciona/portafolio-mich (main)
$ ls
index.html    public/  vite.config.js
package.json  src/

package.json内容

{
  "name": "portafolio-mich",
  "private": true,
  "version": "0.0.0",
  "type": "module",
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "preview": "vite preview"
  },
  "dependencies": {
    "react": "^18.2.0",
    "react-dom": "^18.2.0"
  },
  "devDependencies": {
    "@types/react": "^18.0.28",
    "@types/react-dom": "^18.0.11",
    "@vitejs/plugin-react": "^3.1.0",
    "vite": "^4.2.0"
  },
  "description": "portafolio de Michelle con sus proyectos",
  "main": "index.html",
  "keywords": [
    "portafolio"
  ],
  "author": "Michelle",
  "license": "ISC"
}

解决方案 #

1. 检查并重置npm配置 #

• 查看当前npm前缀和缓存路径：

  npm config get prefix
  npm config get cache
  

• 确认路径存在且当前用户有读写权限，若路径异常，重置配置：
  • Windows：npm config set prefix C:\Users\你的用户名\AppData\Roaming\npm
  • Mac/Linux：npm config set prefix ~/.npm

2. 强制清理npm缓存 #

npm cache clean --force

清理完成后重新执行npm install

3. 升级npm版本 #

若当前npm版本低于8.x，执行升级：

npm install -g npm

4. 解决系统权限问题 #

• Windows：以管理员身份启动终端后执行命令
• Mac/Linux：避免使用sudo，若必须使用，修复npm目录权限：

  sudo chown -R $USER:$GROUP ~/.npm
  

5. 切换npm镜像源（解决网络问题） #

• 临时使用国内镜像安装：

  npm install --registry=https://registry.npmmirror.com
  

• 永久设置国内镜像：

  npm config set registry https://registry.npmmirror.com
  

6. 检查.npmrc配置文件 #

• 删除项目根目录及用户主目录下的.npmrc文件中可能存在的异常配置（如ignore-scripts=true）

7. 换用包管理器测试 #

尝试使用pnpm或yarn替代npm：

• 安装pnpm并执行安装：

  npm install -g pnpm
  pnpm install
  

• 或安装yarn并执行安装：

  npm install -g yarn
  yarn install
  

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