webstorm内置服务器始终运行，无需手动启动；右键html文件即可通过http://localhost:63342访问，端口可在settings→debugger→built-in server port修改，修改后需重启ide并更新url，且仅支持本地预览、不代理api、不执行构建。
WebStorm内置服务器根本不用“启动”
它始终在运行，你不需要点任何按钮、也不用执行命令——只要右键打开 index.html 或其他 HTML 文件，WebStorm 就自动通过内置 HTTP 服务提供该文件。所谓“配置 Web Server”，其实是调整它的行为边界，而不是开关服务。
常见误解是：点了 Open in Browser 没反应 → 以为服务器没起来。实际原因通常是：
- 右键的是
.js或.css文件，不是 HTML —— 内置服务只响应 HTML 请求 - 项目根目录下没有
index.html，又只点了文件夹而非具体 HTML 文件 - 路径含中文或空格（尤其旧版 WebStorm），导致 URL 解析失败
-
Can accept external connections被关闭，但你试图用127.0.0.1访问（Chrome 调试协议对 host 名敏感，必须用localhost）
改端口：Settings → Debugger → Built-in server port
默认端口 63342 可能被占，或你想统一为 8080 方便记忆。修改后注意：
- 必须重启 WebStorm 才生效
- 所有旧 URL（如
http://localhost:63342/index.html）立即失效，要手动改成新端口 - 端口必须 ≥1024；若设为
80或443，需管理员权限（不推荐） - WebStorm 静默 fallback 到下一个可用端口（如
63343）时，不会弹窗提醒，容易误判服务异常
JavaScript Debug 配置里的 URL 必须严格匹配
这是最常出错的一环。当你配置 JavaScript Debug 运行配置时，URL 字段不是随便填的：
- 格式固定：
http://localhost:<port>/<project-root-relative-path></project-root-relative-path></port> - 例如项目名
my-app，HTML 在src/index.html，端口8080→ 填http://localhost:8080/src/index.html - 不能写
file:///路径，也不能用http://127.0.0.1替代localhost - 如果页面内有
fetch('/api/user')这类相对请求，内置服务器不代理，会 404 —— 此时必须换用vite dev或webpack serve
想让手机访问？得配 Deployment + 开放外网
内置服务器默认只响应 localhost，手机连不上。要局域网访问，必须做两件事：
- 在
Settings → Build, Execution, Deployment → Debugger中勾选Can accept external connections，并设好端口（如8080） - 进
Settings → Build, Execution, Deployment → Deployment，新增Local or mounted folder类型配置：
–Folder填项目根路径（如D:\my-app）
–Web server root URL填http://:8080（用ipconfig查）
–Mappings → Web path on server填/my-app（对应项目最后一级目录名） - 完成后右键 HTML →
Open in Browser，生成的链接就是手机可访问的地址
真正容易被忽略的是：这个“本地服务器”只是静态文件托管器，不执行构建、不解析 import、不热更新。你看到页面跑起来了，不代表它真在模拟生产环境——现代前端项目该用什么开发服务器，还得靠 npm 脚本驱动。
