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://<本机IP>:<端口号>（用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。这两个动作不做，其他设置全白搭。
