WebStorm内置服务器默认运行,无需启动;端口在Settings→Tools→Web Browsers and Preview→Built-in server port修改,默认63342,须≥1024且重启IDE生效,改后旧链接失效;仅支持本地预览,局域网访问需勾选Can accept external connections并配置Deployment映射。

WebStorm 的内置服务器不需要“配置启动”,它默认就开着——只要右键打开 .html 文件,你就已经在用它了。所谓“配置”,其实只是调端口、改路径、开局域网访问这三件事,其他全是多余操作。
内置服务器端口在哪改?怎么改才不踩坑
端口设置藏在 Settings/Preferences → Tools → Web Browsers and Preview → Built-in server port 里,默认是 63342。
- 必须填 ≥1024 的空闲端口(比如
8080、8888),低于 1024 需要管理员权限,WebStorm 不会提醒你失败,只会静默换到下一个端口(如63343) - 改完必须重启 WebStorm,否则旧 URL(如
http://localhost:63342/index.html)立刻失效,但 IDE 不提示,容易以为“没生效” - 端口被占时 WebStorm 不报错也不弹窗,只悄悄换端口——建议改完后直接在浏览器里输新地址验证
为什么右键 Open in Browser 没反应
不是服务器没起来,而是触发条件没满足:
- 只对
.html文件有效;右键.js、.css或文件夹,不会走内置服务 - 项目根目录下没有
index.html?那就必须右键具体 HTML 文件,不能点文件夹再选“Open in Browser” - 路径含中文或空格?某些版本 WebStorm 会卡住或返回空白页,换成纯英文路径(如
my-project/index.html)立马解决 - 检查
Tools → Web Browsers and Preview是否勾了Can accept external connections——虽然不影响本地访问,但若误关,连localhost都可能被拦截
想让手机或同事访问,关键三步不能漏
内置服务器默认只响应 localhost,要局域网访问得手动放开:
- 第一步:把端口改成常用值(如
8080),并勾选Can accept external connections - 第二步:在
Settings → Build, Execution, Deployment → Deployment里新增一个Local or mounted folder类型的服务器配置,Folder填项目根目录绝对路径,Web server root URL填http://[你的IP]:[端口](如http://192.168.1.105:8080) - 第三步:切换到
Mappings标签页,确保Local path和上面一致,Web path on server填/或项目子目录名(如/my-app),别留空
做完这三步,复制 http://[你的IP]:[端口]/xxx.html 给手机,同 Wi-Fi 下就能打开——但注意:它仍是静态托管,不处理 import、不代理 /api、不编译 Vue/React,真要跑框架项目,还得靠 vite dev 或 npm start。


















