vite 端口被占用后移

### 解决 Vite 端口被占用问题并移动到其他端口

当遇到 Vite 开发服务器启动失败提示端口已被占用的情况时，可以通过修改配置文件或命令行参数指定不同的端口号来解决问题。

#### 方法一：通过命令行参数更改端口
可以直接在启动 Vite 的时候通过 `--port` 参数指定新的端口号：

npm run dev -- --port 3001

这将会让 Vite 使用 3001 号端口而不是默认的 3000 来运行开发服务器[^3]。

#### 方法二：编辑 vite.config.js 文件永久改变端口
如果希望每次启动都自动使用特定端口，则可以在项目根目录下的 `vite.config.js` 文件中加入如下配置项：

export default defineConfig({
  server: {
    port: 3001,
    strictPort: true // 如果该端口不可用则抛出错误而非尝试下一个可用端口
  }
})

这样可以确保即使重启计算机之后也依然保持相同的自定义端口设置。

#### 方法三：查找并关闭占用端口的服务进程
有时可能是因为之前未完全停止的老实例还在占用着目标端口。此时可先找出哪个程序正在监听这个端口再将其终止掉（Windows 和 Linux 命令有所不同），然后再重新启动 Vite 即可正常工作[^4]。

对于 Windows 用户来说，可以使用 netstat 工具配合 tasklist 查看具体是什么应用程序占用了某个端口；而对于 macOS/Linux 则推荐 lsof 加上 kill 组合拳快速定位和释放资源。

---