Bitbucket流水线中Makefile升级Node致Vite构建异常问题咨询

日志含义解析 #

那段提示是说，n工具把Node.js的可执行文件位置从/usr/bin/node改成了/usr/local/bin/node，但当前shell会话还缓存着旧的路径记录。shell会把常用命令的路径存在hash表里提升效率，所以即便PATH已经更新，当前shell还是会优先用旧路径的Node，除非手动刷新缓存。

为什么影响Vite构建 #

核心问题是当前shell的路径缓存没更新：你执行node -v时可能刚好直接调用了新路径的命令，但Vite构建时，要么是通过npm脚本间接调用，要么shell仍优先使用旧路径的Node版本，新旧Node版本的API、兼容性差异（比如Node 22的新特性或废弃API）导致Vite构建失败。

解决办法 #

• 刷新shell路径缓存：在安装命令后添加hash -r，让shell重新查找node命令的最新路径，完整命令修改为：

  npm install -g n; n latest; hash -r; npm update; node -v
  

• 直接指定新路径执行Vite构建：绕开shell路径缓存问题，把构建命令改成：

  /usr/local/bin/node ./node_modules/vite/bin/vite.js build
  

• 调整PATH优先级：安装Node后把新路径加到PATH最前面，确保新Node优先被识别：

  npm install -g n; n latest; export PATH=/usr/local/bin:$PATH; npm update; node -v
  

• 用n exec直接指定版本执行命令：无需手动处理路径，让n直接调用指定版本Node执行构建：

  npm install -g n; n exec latest npm run build
  

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