WebStorm 中真正的 Web 服务配置在 Deployment 页面(Ctrl+Alt+S 搜索 deployment),而非 Debugger 或 Run Configurations;内置静态服务器端口 63342 不可修改,局域网访问需依赖外部服务(如 Vite)监听 0.0.0.0 并放行防火墙端口。

直接打开 Deployment 设置页面
WebStorm 没有叫“Web服务器配置”的独立窗口,真正对应的是 Deployment 配置页——它管的是本地/远程文件同步、根路径映射、URL预览等,不是启动 HTTP 服务本身。快捷方式最可靠:Ctrl+Alt+S(Windows/Linux)或 Cmd+, (macOS),然后在设置搜索框里输入 deployment,直接跳转到 构建、执行、部署 | 部署 页面。
别误点成 Debugger 或 Run Configuration
很多人搜“web server”会点进 Debugger 设置(比如改调试端口、勾选 can accept external connections),但这只影响 JS 调试器连接,和静态文件服务无关;也有人去 Run | Edit Configurations 新建 JavaScript Debug,那只是配浏览器 URL 打开地址,不启动任何服务进程。真正的文件托管行为由以下两种方式触发:
- 右键 HTML 文件 →
Open in Browser:触发内置静态服务器(端口固定为63342,不可改) - 运行
npm start等脚本:由 package.json 中定义的命令启动外部服务(如 Vite、Express),WebStorm 只负责执行命令,不参与配置
修改内置服务器端口?做不到
WebStorm 内置的 63342 端口是硬编码的,没有 UI 选项让你改。如果这个端口被占用了,它会自动尝试下一个可用端口(比如 63343),但不会提示你。你看到的地址栏 URL 是 http://localhost:63342/xxx,这个数字不能手动指定,也不建议用防火墙或 hosts 去绕——它只用于开发预览,不对外暴露。
想让手机访问本地项目?关键不在 Deployment
要让局域网内其他设备(比如手机)访问 WebStorm 启动的服务,重点不是 Deployment,而是两点:
- 确保你用的是外部服务(如
npm run dev启动的 Vite),且该服务本身监听了0.0.0.0(不是127.0.0.1)——这由框架配置决定,和 WebStorm 无关 - 关闭本地防火墙或放行对应端口(比如
5173),Deployment里的Local or mounted folder类型配置对此毫无作用
很多人卡在“填了 IP 却打不开”,其实根本没跑对命令,或者 Node.js 服务压根没起来——先在终端里手动跑一遍 npm run dev 确认能用 http://192.168.x.x:5173 访问,再回头配 WebStorm 的 Run Configuration。


















