用途
nvm Troubleshooting (Linux/WSL) 用于在 Linux 发行版和 Windows Subsystem for Linux（WSL）环境中诊断并修复 nvm 的常见问题。它面向遇到 nvm 无法使用、命令找不到、配置不生效等情况的开发者，提供一套可执行的排查与修复流程。
主要能力
该技能覆盖以下问题类型：
- 配置文件未加载（profile not loading），这是最常见的问题；
- PATH 错误；
- 不同发行版之间的差异（distro-specific differences）；
- Alpine 兼容性问题。
使用方式
技能以工作流（Workflow）形式组织，按步骤执行：
- 运行诊断检查：
echo "Shell: $SHELL"
echo "NVM_DIR: $NVM_DIR"
cat ~/.bashrc | grep -n nvm
echo $PATH | tr ':' '\n' | grep nvm
- 识别发行版和 Shell：
cat /etc/os-release | head -2
echo $SHELL
# WSL check:
uname -r | grep -i microsoft && echo "WSL detected"
- 修复配置文件加载问题（最常见问题）：
# Ensure these lines are in ~/.bashrc (not just ~/.profile):
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
- 验证修复：
source ~/.bashrc
command -v nvm # Should print "nvm"
nvm --version
示例文件
技能附带以下示例文件：
- examples/troubleshooting-linux.md - Linux 专属排错
- examples/wsl-troubleshooting.md - WSL 专属问题
- examples/alpine-install.md - Alpine Linux 指引
- examples/problems.md - 常见问题与解决方案
- examples/compatibility-issues.md - 已知兼容性问题
适用场景
适用于在 Linux 或 WSL 上使用 nvm 时遇到配置不加载、PATH 异常、发行版差异或 Alpine 兼容性问题的开发者。
限制
安装步骤属于 nvm-install；macOS 问题应使用 nvm-troubleshooting-macos。