WSL中npm安装JHipster后启动失败求助

1. 检查并匹配Node.js版本兼容性 #

JHipster各版本对Node.js有明确要求：

• JHipster 8：Node.js 18.x / 20.x
• JHipster 7：Node.js 14.x / 16.x / 18.x

先查看当前Node版本：

node --version

如果版本不符，用nvm管理Node版本（WSL环境推荐）：

1. 安装nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

2. 重启终端后，安装对应版本（以JHipster 8所需的Node 18为例）：

nvm install 18
nvm use 18

3. 重新安装JHipster：

npm install -g generator-jhipster

2. 升级WSL版本并更新系统 #

JHipster对WSL2的兼容性更好，若当前是WSL1，建议升级：

1. 查看WSL版本：

wsl --list --verbose

2. 升级目标发行版到WSL2（以Ubuntu为例）：

wsl --set-version Ubuntu 2

3. 更新WSL内的系统包：

sudo apt update && sudo apt upgrade -y

3. 清理npm缓存与残留文件 #

缓存或残留安装文件可能导致异常：

1. 清理npm缓存：

npm cache clean --force

2. 卸载全局JHipster：

npm uninstall -g generator-jhipster

3. 删除残留安装目录：

rm -rf /usr/local/lib/node_modules/generator-jhipster

4. 重新安装指定版本（以JHipster 7.9.3稳定版为例）：

npm install -g generator-jhipster@7.9.3

4. 修复全局npm包权限问题 #

避免用sudo安装全局npm包，配置用户级全局目录：

1. 创建用户级npm全局目录：

mkdir -p ~/.npm-global

2. 设置npm前缀：

npm config set prefix '~/.npm-global'

3. 将目录加入环境变量：

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

4. 重新安装JHipster：

npm install -g generator-jhipster

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