Vue.js更改调试地址端口号

admin 54 0
在Vue.js项目中修改调试端口,通常需编辑根目录下的vue.config.js文件,在devServer配置项中,将port属性修改为指定数字即可,保存文件并重启开发服务器后,应用将在新的端口号上运行,从而解决默认端口冲突的问题,或适应特定的开发环境需求。

Vue.js 开发环境端口冲突?Vue CLI 与 Vite 修改调试端口全攻略

在 Vue.js 的日常开发中,默认的调试端口 8080 往往是“众矢之的”,由于该端口使用率极高,一旦本地安装了多个开发环境服务(如 IDEA 自带的 Tomcat),或者某些系统服务占用了该端口,就会导致项目启动失败或服务无法访问。

为了解决这一痛点,开发者通常需要手动指定一个新的调试端口,本文将详细介绍在不同版本的 Vue 项目中,如何优雅地修改调试地址的端口号。

Vue CLI 项目(Vue 2 或 Vue 3 默认脚手架)

如果你使用的是传统的 Vue CLI 创建的项目,修改端口号主要通过项目根目录下的 vue.config.js 文件来实现。

检查与创建配置文件

请在项目根目录下查找是否存在 vue.config.js 文件。

  • 如果存在:直接进行第 2 步。
  • 如果不存在:请手动创建一个 JS 文件,命名为 vue.config.js

配置端口与优化项

在文件中引入 module.exports,并在 devServer 属性下进行配置,除了端口,建议一并配置 open(自动打开浏览器)和 proxy(代理设置)。

// vue.config.js
module.exports = {
  devServer: {
    port: 8081,           // 修改为你想要的端口号,8081
    open: true,           // 可选:配置为 true,启动服务后自动打开浏览器
    // proxy: { ... }     // 可选:配置开发环境的接口代理
  }
}

操作提示:保存文件后,必须重启开发服务器(即重新运行 npm run serveyarn serve),配置才会生效。


Vite 项目(Vue 3 + Vite)

随着 Vue 3 的普及,Vite 已成为默认构建工具,Vite 的配置更加现代化,基于 ES Module,配置文件通常位于根目录。

打开配置文件

找到项目根目录下的 vite.config.js(或 .ts)文件。

配置 Server 属性

export default 导出的对象中,找到 server 属性进行修改。

// vite.config.js
export default {