Ubuntu系统Visual Studio Code终端无法使用npm命令问题咨询

问题原因 #

出现sh: npm: command not found报错的核心是VS Code内置终端的运行环境中，无法找到npm命令的可执行文件，常见触发场景如下：

• 系统未安装Node.js/npm：Ubuntu系统默认不预装Node.js运行环境和配套的npm包管理器
• 已安装但环境变量未加载：如果通过nvm、二进制包等非apt默认路径方式安装Node.js，VS Code内置终端未正常加载.bashrc/.zshrc等shell配置文件，导致PATH中没有npm的执行路径
• VS Code终端配置异常：内置终端默认调用的是sh而非用户常用的bash/zsh，没有加载用户级的环境变量配置

解决步骤 #

第一步：确认系统是否安装Node.js/npm #

先在系统自带的原生终端（不是VS Code内置终端）执行以下命令验证：

node -v
npm -v

如果两个命令都正常返回版本号，说明已完成安装，直接跳转到第二步操作；如果同样提示命令不存在，执行以下命令安装适配Angular开发的Node.js版本即可：

以下命令安装Node.js 18.x版本，为当前Angular框架主流兼容的长期支持版本

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

安装完成后再次执行node -v、npm -v确认版本正常返回即可。

第二步：修复VS Code内置终端环境变量问题 #

如果系统原生终端可以正常执行npm命令，仅VS Code内置终端报错，按以下操作排查：

• 完全关闭所有VS Code进程后重新打开，再次尝试执行npm命令，部分场景是VS Code启动时未加载最新的系统环境变量
• 修改VS Code默认终端配置：按下Ctrl+,打开设置页，搜索terminal.integrated.defaultProfile.linux，下拉选择bash或者你系统当前常用的zsh，不要选择默认的sh
• 手动加载shell配置：如果仍报错，在内置终端执行source ~/.bashrc（使用zsh的用户执行source ~/.zshrc）后再尝试执行npm命令

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