WSL2 Ubuntu环境通过nvm或apt均无法安装node/npm的故障

问题根因 #

你碰到的报错是多个操作错误叠在一起导致的：

• 装完nvm没装Node本身：nvm只是版本管理工具，安装完成后不会自带任何Node版本，你没执行nvm install命令装具体版本，nvm ls看不到版本是正常的，里面显示的system条目是后续你用apt装的损坏的系统级Node，因为跑不起来所以所有版本别名都显示N/A。
• apt安装的Node报Exec format error、ELF not found是二进制格式不匹配：要么是你apt源混了arm/amd64架构拉错了安装包，要么是WSL的PATH里Windows路径优先级太高，错把Windows端的Node程序当成Linux二进制执行。另外你最开始设置nvm镜像的命令写错了——code是VSCode的启动命令，你那行等于用VSCode打开了个叫export的文件，根本没把镜像源配置写到环境变量里。

分步修复 #

按顺序执行，不要跳步：

• 先彻底清理之前装坏的所有Node相关文件

  apt remove --purge -y nodejs npm
  apt autoremove -y
  rm -rf /usr/bin/node /usr/bin/npm /usr/local/bin/node /usr/local/bin/npm ~/.npm ~/.node-gyp ~/.nvm
  

• 确认WSL运行状态正常
  先在Windows的PowerShell里执行wsl -l -v，确认你装的Ubuntu版本对应的VERSION是2，不是1。如果是1就执行wsl --set-version Ubuntu-22.04 2转成WSL2，再进Ubuntu终端执行uname -m，正常输出应该是x86_64，如果输出aarch64说明你装错了系统镜像，换amd64版本的Ubuntu22.04重装。
• 修复apt源架构配置

  dpkg --remove-architecture arm64
  dpkg --add-architecture amd64
  apt update
  

• 重新安装nvm并用nvm装Node（别用apt源里的Node12，早就过维护期了）
  没代理的话直接用国内镜像，避免下载失败或者下到损坏的包：

  # 配置nvm国内镜像
  export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
  export NVM_SOURCE=https://npmmirror.com/mirrors/nvm
  # 安装nvm
  curl -o- $NVM_SOURCE/install.sh | bash
  # 加载nvm环境
  source ~/.bashrc
  # 安装Node 20 LTS长期支持版本
  nvm install 20
  # 设为默认版本
  nvm use 20
  nvm alias default 20
  # 验证安装
  node -v
  npm -v
  

• 如果还是报二进制执行错误，修复PATH优先级
  编辑~/.bashrc文件，在最末尾加一行，把Linux系统路径放到Windows路径前面，避免WSL错调Windows上的程序：

  export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:$PATH
  

  保存后执行source ~/.bashrc再验证node命令即可。

避坑提示 #

• 以后装nvm之后必须手动执行nvm install 版本号才会安装对应Node，不要以为装了nvm就自带Node
• 没挂代理的时候不要直接连GitHub、nodejs.org的官方源，换成国内镜像避免下载中断导致安装包损坏
• WSL里尽量用nvm装Node，不要用apt源里的版本，不仅版本老，还容易因为依赖问题出各种奇怪报错

内容的提问来源于stack exchange，提问作者mark-hahn