webstorm内置服务器端口在settings → advanced settings → built-in server port(或settings → tools → web browsers and preview → built-in server port)修改,默认63342,需设为≥1024的空闲端口;改完必须重启ide且手动更新所有javascript debug配置中的url,否则因服务未监听新端口或地址失效导致err_connection_refused。

WebStorm内置服务器端口在哪改,改完为什么打不开
WebStorm内置服务器没有“启动/停止”开关,端口由IDE全局控制,改错位置或漏重启就必然失效。关键路径是:Settings → Advanced Settings → Built-in Server Port(部分版本路径为 Settings → Tools → Web Browsers and Preview → Built-in server port)。默认值63342,可设为≥1024的空闲端口(如8080、8888)。
改完必须重启WebStorm,否则旧端口仍被监听,新端口不生效;同时所有已存的JavaScript Debug运行配置里的URL地址(如http://localhost:63342/index.html)需手动更新,否则浏览器会报ERR_CONNECTION_REFUSED。
- 端口被占用时,WebStorm会静默切换到下一个可用端口(如
63343),但不提示,容易误判服务未启动 - 改端口后旧链接立刻失效,不是“兼容跳转”,而是彻底不可达
- 不要在
JavaScript Debug配置的URL字段里硬改端口——它不控制服务,只指定访问地址
如何让手机或同事电脑访问WebStorm内置服务
默认情况下,WebStorm内置服务器只绑定localhost,局域网设备无法访问。要开放外部连接,需两步:启用外部监听 + 配置Deployment映射。
第一步,在Settings → Debugger → Built-in Server中:勾选 Can accept external connections,并确认端口已设为非63342(建议避开8080防冲突,用8888或3001更稳妥)。
第二步,进Settings → Build, Execution, Deployment → Deployment,点+添加类型为Local or mounted folder的配置:
-
Folder填项目根目录(如D:\my-project) -
Web server root URL填http://:(用ipconfig查IPv4地址,如http://192.168.1.105:8888) - 切到
Mappings页签,Local path与上面一致,Web path on server填/或子路径(如/my-app),避免404
完成后右键HTML文件→Open in Browser,地址栏显示的就是带IP和端口的可外访链接。
JavaScript Debug配置和内置服务器端口的关系
JavaScript Debug运行配置本身不启动任何服务,它只是告诉浏览器去连哪个URL——而那个URL背后的服务,必须由WebStorm内置服务器提供且已在监听对应端口。
常见错误包括:
- 在
JavaScript Debug的URL里写http://localhost:8080/xxx.html,但没改Built-in Server Port,结果服务根本没在8080上跑 - 改了端口但没重启IDE,浏览器访问
8080时返回ERR_CONNECTION_REFUSED - URL路径写错层级(比如漏掉子文件夹名),导致404,误以为端口没生效
正确做法:确保Built-in Server Port已设为目标端口 → 重启WebStorm → 更新所有JavaScript Debug配置中的URL → 再运行。
安全性和实际使用中容易忽略的点
WebStorm内置服务器设计用于本地开发预览,不提供身份验证、HTTPS、CORS策略控制等生产级能力。开启Can accept external connections后,同局域网内任何设备只要知道IP和端口就能访问,等同于暴露本地文件系统的一部分。
- 测试结束后建议关闭该选项,或至少换回非通用端口(如不用
8080),降低被扫描发现概率 - 中文路径在部分手机浏览器中会因编码问题加载失败,前端资源路径尽量用英文+数字
- 如果项目含API调用,注意前端代码里的
fetch地址仍指向localhost,和内置服务器端口无关,需单独处理代理或CORS - 它和
npm start、vue-cli-service serve完全无关——后者是独立Node进程,端口由脚本自身控制
最常被跳过的动作:改完端口不重启IDE,以及忘记同步更新所有已存的运行配置URL。这两个动作不做,其他设置全白搭。











