启动应用出现[Node version error]错误：如何降级Node.js解决？

Hey there, let’s fix that Node version error once and for all— I’ve dealt with this exact frustration more times than I can count, so I know the steps that actually work. Here’s how to get your app up and running by switching or downgrading your Node.js version properly:

Before you start switching versions, you need to know the exact version your application is built for. Here’s how to find it:

• Check your project’s package.json file for the engines section. It’ll look something like this: "engines": { "node": "16.x" } — this tells you the compatible major version.
• If there’s no engines field, flip through the project’s README or documentation. Most projects list supported Node versions there.
• Re-read the error message itself! Sometimes it explicitly states which version is required (e.g., “Expected Node.js >=14.x, found 18.x”).

Manually installing/uninstalling Node versions is messy and error-prone. A version manager lets you switch between versions in seconds. My favorite is NVM (Node Version Manager), which works on Windows, Mac, and Linux.

If you don’t have NVM installed yet: #

Grab it from the official NVM repo (no external links needed— just search for “nvm install” and follow the OS-specific steps). Once installed:

1. Close and reopen your terminal (critical— the path changes won’t take effect in existing windows).
2. Install the required version: nvm install 16.18.0 (replace 16.18.0 with your app’s specific version).
3. Switch to that version immediately: nvm use 16.18.0
4. Set it as the default for all new terminals: nvm alias default 16.18.0

If you prefer using n (another lightweight version manager): #

If you’d rather stick with npm-based tools, n is a great alternative:

1. Install it globally: npm install -g n
2. Install your target version: n 16.18.0
3. Switch to it (this also sets it as default): n use 16.18.0

Don’t skip this— it’s easy to assume it worked, but double-checking saves time later. Run these commands in your terminal:

• node -v — this should output the version you just installed.
• npm -v — npm versions are tied to Node, so this should update automatically to a compatible version.

Even after switching Node versions, old, incompatible dependencies can still cause errors. Do this to reset your project:

1. Delete the node_modules folder:
   • Mac/Linux: rm -rf node_modules
   • Windows (Command Prompt): rmdir /s node_modules
2. Delete your lock file (package-lock.json or yarn.lock — this ensures you install dependencies compatible with your new Node version).
3. Reinstall dependencies: npm install or yarn install

• NVM isn’t recognizing the installed version: Close all terminal windows and reopen them. Sometimes the system path doesn’t update until you do this.
• Permission errors: On Mac/Linux, never use sudo with npm or NVM— they’re designed to run without elevated privileges. If you already have permission issues, fix your npm folder ownership with sudo chown -R $(whoami) ~/.npm.
• Windows issues: Make sure you’re using Command Prompt or PowerShell (Git Bash can sometimes have NVM path issues). If you hit permission blocks, run your terminal as administrator.

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