刚装好WebStorm应优先排除node_modules等目录、禁用无关插件、调整vmoptions内存参数（如-Xms512m -Xmx2g），并确认Node.js/TypeScript语言服务正确启用，否则将导致卡顿、补全失效、跳转异常。
刚装好 WebStorm 的人，最该优先做的不是写代码，而是把工作空间配成“能干活不卡顿、改代码不踩坑”的状态。否则后面越用越慢、补全失灵、文件乱跳，全是配置没到位埋的雷。
怎么快速让编辑器不卡、启动变快
WebStorm 启动慢、打开项目卡顿，90% 是因为默认索引了所有文件、插件堆太多、JVM 内存没调对。
- 右键
node_modules→ 选「Mark Directory as」→「Excluded」；同理处理dist、build、.git（如果它没自动排除） - 进
Settings | Plugins，关掉所有没真正在用的插件，尤其是一次性试用过的 Markdown 渲染类、主题类、AI 辅助类插件 - 通过
Help | Edit Custom VM Options…打开webstorm.vmoptions，把-Xmx改成-Xmx2g（16GB 内存机器），-Xms设为-Xms512m；别设太高，超了反而触发频繁 GC
代码补全和跳转为什么经常失效
补全不弹、Ctrl+Click 跳不到定义、Alt+F7 找不到引用——不是 IDE 坏了，是语言服务没认准项目结构。
- 确保项目根目录下有
package.json，且已正确识别为 Node.js 项目（右下角状态栏应显示Node.js图标） - 进
Settings | Languages & Frameworks | JavaScript | Libraries，确认node_modules已被自动添加为 JavaScript library；如果没有，点「Add…」→ 选中node_modules文件夹 - 如果用了 TypeScript，必须装
@types/*包，并在Settings | Languages & Frameworks | TypeScript中启用「TypeScript language service」，别依赖内置的轻量模式
本地开发服务器怎么配才不手动刷新
每次改完 HTML/CSS/JS 都要切浏览器按 F5？说明 Live Edit 或本地服务器映射没通。
- 先确认本地已有运行中的 Web 服务（如
http-server、live-server、MAMP/XAMPP），或直接用 WebStorm 自带的「Built-in web server」（需开启） - 进
Settings | Tools | Web Browsers and Preview，勾选「Use built-in web server for static files」，端口默认是 63342 - 右键 HTML 文件 →「Open in Browser」→ 选 Chrome/Firefox，URL 会是
http://localhost:63342/xxx.html；改完保存，浏览器自动刷新（需页面里没禁用 Live Edit） - 若用自建服务（如
npm start），别配 Deployment，改用Run | Edit Configurations…新增NPM类型脚本，勾选「After launch」→「Open browser」，填http://localhost:3000
团队协作时哪些配置必须提交到 Git
.idea 文件夹里大部分内容不该提交，但漏掉关键几项，队友拉代码后就得重配一遍。
- 必须提交：
.idea/modules.xml、.idea/workspace.xml（含 Run Configuration）、.idea/vcs.xml（VCS 绑定）、.idea/jsLibraryMappings.xml（JS 库映射） - 必须忽略：
.idea/workspace.xml里的临时 UI 状态（如打开的标签页、断点位置），可通过.idea/.gitignore过滤；更稳妥的是用官方推荐的.gitignore模板，搜「JetBrains .gitignore」 - 别碰
.idea/misc.xml和.idea/encodings.xml—— 它们含机器本地路径和编码设置，一提交就冲突
真正难的不是配多少项，而是分清哪些该全局设、哪些得 per-project 设、哪些压根不该进 Git。比如字体大小调一次就行，但 JS 库路径、服务器映射、Run Configuration 都得跟着项目走。配错一层，后面所有功能都打折。
