启动Vite开发服务器报错getaddrinfo ENOTFOUND localhost求助

一、核心问题：修复localhost解析失败 #

这个错误是系统无法将localhost解析到127.0.0.1，直接修改hosts文件解决：

• Windows系统：打开C:\Windows\System32\drivers\etc\hosts，添加一行：127.0.0.1 localhost
• Mac/Linux系统：终端执行sudo nano /etc/hosts，添加127.0.0.1 localhost，按Ctrl+O保存、Ctrl+X退出
  修改后执行ping localhost测试，能收到来自127.0.0.1的响应就说明解析正常。

二、修复Vite命令找不到的问题 #

之前出现sh: vite: command not found，大概率是依赖安装不完整或本地命令映射异常：

1. 先清理现有依赖和锁文件：

   # Mac/Linux
   rm -rf node_modules package-lock.json yarn.lock
   # Windows
   rmdir /s node_modules
   del package-lock.json yarn.lock
   

2. 重新安装依赖，优先用npm ci保证依赖版本一致：

   npm ci
   

   若没有package-lock.json，再用npm install。不要直接用npm audit fix，它可能升级依赖导致兼容性问题，漏洞修复建议后续单独处理。
3. 启动服务器时，优先用npx调用本地Vite：

   npx vite
   

   或直接执行npm run dev（前提是package.json的scripts里配置了"dev": "vite"）

三、其他排查方向 #

• 确认VS Code终端和系统终端使用同一环境：执行node -v和npm -v，确保版本正常且路径一致
• 暂时关闭代理或VPN：部分代理工具会干扰DNS解析，关闭后重试启动

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