运行/调试配置必须设为永久,右键入口文件生成临时配置后需点击齿轮图标保存并命名(如dev-server),勾选Allow parallel run;Windows下Node.js需添加--inspect、chcp 65001等参数;HTML双击打开需配置Deployment映射URL;IdeaVim插件易导致快捷键失效,应禁用或正确配置Vim Emulation。

运行/调试配置必须设为永久,否则改完代码还得手动选
临时配置在重启 IDE 或切换项目后就没了,Run 按钮旁边那个半透明图标就是它——每次改完代码想 Ctrl+Shift+F10 重跑,结果发现配置丢了,得重新点 Run | Edit Configurations... 手动配一遍。
- 右键点击入口文件(如
index.js或server.js),选Run 'xxx',生成临时配置 - 立刻在右上角配置下拉框里选中它,点击齿轮图标 →
Save Configuration - 名称建议带环境标识,比如
dev-server或test-node,避免和别人冲突 - 勾选
Allow parallel run,否则启动第二个服务时会自动杀掉第一个
中文乱码?不是编码问题,是 Node.js 启动参数没加
新建的 Node.js 配置默认不带 --inspect 和 chcp 65001,Windows 下直接跑 console.log('你好') 就是乱码,不是文件编码错了,也不是终端设置问题。
- 打开
Run | Edit Configurations...,选中你的 Node.js 配置 - 在
Node options栏填入:--inspect --no-warnings(调试必备) - 在
Environment variables里加:NODE_OPTIONS=--experimental-specifier-resolution=node(适配 ESM) - Windows 用户务必在
Working directory下方勾选Use project root as working directory,再在Before launch里加个Run External tool:命令填cmd,参数填/c chcp 65001 > nul
HTML 文件双击打不开浏览器?是因为没配默认浏览器和 URL 映射
直接双击 index.html,WebStorm 只会用内置编辑器打开,不会启动本地服务器——这不是 bug,是它默认当纯静态文件处理。要真能预览,得让 IDE 知道“这个 HTML 应该走哪个 URL”。
- 进
Settings | Tools | Web Browsers,把 Chrome 或 Edge 设为Default browser - 然后去
Settings | Build, Execution, Deployment | Deployment,添加一个Local or mounted folder类型配置 -
Folder填你项目根路径(如D:\my-project),Web server URL填http://localhost:63342/my-project(端口是 WebStorm 内置服务器默认端口) - 右键
index.html→Open in Browser,这时才真正走本地 HTTP 服务,JS/CSS 路径才不会 404
快捷键失效或冲突?先关 IdeaVim 插件再查键位图
装了 IdeaVim 插件却没启用 Vim 模式,或者启用了但没配好 .ideavimrc,会导致 Ctrl+C 复制变粘贴、Ctrl+Shift+F 全局搜索打不开——根本不是快捷键被占用了,而是输入模式被劫持了。
- 按
Ctrl+Shift+A,搜Plug-ins,禁用IdeaVim插件,重启 IDE 看是否恢复 - 如果确实要用 Vim 操作,别只开插件,还要在
Settings | Keymap里选Vim Emulation方案 - 常用组合键优先级:IDE 自带键位 > 插件键位 > 系统全局热键;比如
Ctrl+Alt+L格式化,在 IdeaVim 下默认是 Vim 的:set list,得手动映射 - 所有快捷键最终生效路径是:
Settings | Keymap | [你的方案] | Other | Reformat Code,右键可复制快捷键路径用于排查
Deployment 里的 URL 映射,以及 Node.js 配置里没开 Allow parallel run——这两个不设,初学者基本跑不起来真实开发流。


















