WSL2重启后NodeJS、NVM及npm消失问题求助

可能的原因及解决办法 #

• 环境变量未持久化：NVM安装时会在~/.bashrc（或对应shell的配置文件）中添加初始化配置。若WSL实例导出/导入后，配置文件被重置或路径关联失效，重启后NVM初始化脚本不会自动执行。

  • 检查~/.bashrc末尾是否存在以下NVM配置代码：

    export NVM_DIR="$HOME/.nvm"
    [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # 加载nvm
    [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # 加载nvm自动补全
    

    若缺失，手动添加后执行source ~/.bashrc使配置生效；也可重新运行NVM安装脚本完成配置。

• WSL实例路径变更导致NVM路径失效：当WSL实例被导出再导入到新位置时，用户目录的挂载路径可能发生隐性变化，导致~/.nvm的路径关联异常，NVM无法定位自身安装文件。

  • 解决步骤：
    1. 备份~/.bashrc和~/.nvm中已安装的Node版本配置
    2. 删除~/.nvm文件夹及被修改的shell配置文件
    3. 重新运行NVM安装脚本，让配置适配当前WSL实例的路径

• 默认shell切换未同步配置：若切换了默认shell（如从bash改为zsh），但NVM配置仅添加在原shell的配置文件中，新shell启动时不会加载NVM初始化脚本。

  • 解决：将NVM的配置代码复制到新shell的配置文件（如~/.zshrc）中，执行source ~/.zshrc生效。

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