WebStorm点“Run”没反应是因为未启用内置静态服务器，需右键index.html选“Run 'index.html'”或手动配置JavaScript Debug，URL须匹配项目结构路径，纯HTML/JS/CSS无需Node。
WebStorm 里点“Run”没反应？先确认是否装了内置服务器
WebStorm 本身不带 HTTP 服务器，直接双击打开 index.html 是用文件协议（file://）加载的——这时 fetch、XMLHttpRequest、import 等会因跨域或协议限制直接失败，控制台报 CORS error 或 net::ERR_FILE_PROTOCOL。
正确做法是启用 WebStorm 内置的静态服务器：
- 右键项目根目录或单个
index.html文件 → 选Open in Browser不行，要选Run 'index.html'（首次运行会自动创建配置） - 或者手动配：点击右上角运行配置下拉框 →
Edit Configurations…→ 左侧加号 →Templates → JavaScript Debug→ 右侧URL填http://localhost:63342/your-project-name/index.html（端口默认63342，路径必须和项目结构一致） - 确保
node.js不是必须项——纯 HTML/CSS/JS 项目不需要装 Node，WebStorm 的内置服务走 Java 后端，跟 Node 无关
为什么浏览器打开是空白页或 404？检查路径和 URL 映射
WebStorm 的 Run 配置本质是把项目根目录映射成 http://localhost:63342/ 下的一个子路径。如果项目结构是 my-site/index.html，但你在配置里写的是 http://localhost:63342/index.html（漏了 my-site/），就会 404。
常见错误场景：
立即学习“前端免费学习笔记（深入）”；
- 项目开在
/Users/me/project，但 WebStorm 把整个project当作“源根”，此时index.html的真实 URL 是http://localhost:63342/index.html - 项目开在
/Users/me/project/src，那 URL 就得是http://localhost:63342/index.html，但如果你的资源（比如css/style.css）写的是../css/style.css，路径就容易错位 - 用
<script type="module">时，相对路径解析基于当前 HTML 的 URL，不是文件系统路径 —— 所以import './utils.js'在http://localhost:63342/page/index.html下找的是http://localhost:63342/page/utils.js，不是http://localhost:63342/utils.js
想用本地 Node 服务（如 vite / live-server）？别混用 WebStorm 自带调试
WebStorm 的 JavaScript Debug 配置只对接内置服务器；如果你用终端启了 vite 或 live-server，再点 WebStorm 的 Run 按钮，它不会接管那个进程，反而可能起两个服务、端口冲突。
正确协作方式：
- 终端跑
vite：进项目根目录执行npm run dev，记下实际地址（比如http://localhost:5173/） - WebStorm 中删掉原有的
JavaScript Debug配置，改用Templates → Open in Browser→URL填http://localhost:5173/，这样点运行就只是打开浏览器 - 需要断点调试 JS？在 WebStorm 中打开
Debug工具栏 →Attach to Node.js/Chrome→ 选中正在运行的vite浏览器标签（前提是 Chrome 已开启远程调试） - 注意：
live-server默认不支持 ES 模块热更，vite更稳，但两者都不依赖 WebStorm 的内置服务
修改 HTML 后刷新没更新？缓存和自动重载开关得对上
WebStorm 的内置服务器默认不自动刷新页面，改完 HTML 保存后得手动按 Cmd+R（macOS）或 Ctrl+R（Win/Linux）。如果开了 Live Edit 插件或用了外部服务，行为会不同。
排查要点：
- 确认没误开
Settings → Tools → Debugger → HotSwap → Reload classes after compilation—— 这个是给 Java 用的，对 HTML 无效 - WebStorm 自带的
Live Edit插件（前端开发必备）只支持 CSS 和部分 JS 注入，HTML 修改仍需刷新 - 如果用了
vite，保存即 HMR，但前提是你的index.html不是入口（vite 入口是main.js），否则 HTML 改动仍需全量刷新 - 浏览器强缓存也可能导致旧版本，可临时开 DevTools → Network → 勾选
Disable cache，或用无痕窗口测试
最稳的组合：用 WebStorm 内置服务跑基础 HTML，确保路径干净；复杂项目直接切到终端启 vite，WebStorm 只负责编辑和断点调试 —— 两种模式别叠在一起调。
