webstorm需手动配置系统git路径，否则报“cannot run program 'git'”错误；打开settings→version control→git，填入绝对路径（如windows为c:\program files\git\bin\git.exe），点击test验证版本号成功后方可使用。
安装后立即配置 Git 路径
WebStorm 默认不自动识别系统已装的 Git，即使你本地 git --version 能正常输出，IDE 仍可能报错 Cannot run program "git": error=2, No such file or directory。这不是插件问题，而是路径未绑定。
解决方法很简单：打开 Settings/Preferences → Version Control → Git，在 Path to Git executable 输入框里手动填入 Git 的绝对路径。Windows 常见路径是 C:\Program Files\Git\bin\git.exe，macOS 是 /usr/local/bin/git 或通过 which git 查得，Linux 类似。别依赖“自动检测”按钮——它在某些 shell 环境下会失效。
- 没配好 Git，后续所有
Commit、Pull、Push操作都会灰掉或弹红字报错 - 如果用的是 GitHub Desktop 或 SourceTree 自带 Git，WebStorm 通常找不到它，必须用命令行安装的 Git
- 配完后点
Test按钮验证，成功才继续下一步
新建项目前先关掉“自动创建 .idea 目录”陷阱
WebStorm 每次打开任意文件夹，默认就在其根目录下生成 .idea 文件夹。对新手来说，这容易导致两个问题：一是误把 .idea 提交到 Git 仓库（污染协作环境），二是把临时项目当正式工程长期维护，结果配置越堆越多、越来越难迁移。
真正该做的，是在首次启动后就进入 Settings/Preferences → Appearance & Behavior → System Settings，取消勾选 Use <code>.idea directory for project settings（注意：不是禁用整个项目机制，而是避免无意识生成）。之后新建项目时，明确选择 Empty Project 或模板，并指定独立目录——这样 .idea 才会干净地落在你可控的位置。
- 已经生成了混乱的
.idea？删掉它，再重新用Open → Folder方式打开项目，IDE 会重建一份干净配置 - 团队协作中，务必把
.idea/加进项目根目录的.gitignore，否则队友拉代码后会覆盖本地设置 -
.idea里存的是个人 IDE 配置（如断点、运行配置），不是代码逻辑，不该进版本库
调试前必须确认 Chrome 插件已启用
WebStorm 的 JS 断点调试依赖 JetBrains IDE Support 这个 Chrome 扩展。很多人点了右上角甲虫图标（Debug）却没反应，或者浏览器打不开，根本原因是扩展没装或被禁用。
去 Chrome 应用商店搜 JetBrains IDE Support，装官方版本（作者是 JetBrains s.r.o.），安装后记得在 chrome://extensions/ 页面打开“开发者模式”，并确保该插件右侧开关为开启状态。接着回到 WebStorm，在 Run → Edit Configurations → Defaults → JavaScript Debug 里检查 URL 是否指向你本地服务（如 http://localhost:5500），而不是空或错写成 file:// 协议。
- 用 Live Server 插件起的服务，端口通常是
5500；用npx serve则是3000，URL 必须匹配 - 如果 Chrome 已打开旧标签页，调试时可能复用旧进程导致断点不触发，建议关闭所有相关标签再试
- 断点只对 JS 文件生效，HTML 内联
<script></script>里的代码需在 Sources 面板里手动找对应行设置
别跳过 Playground 项目，但要懂它在哪止步
WebStorm 提供的 Generate a playground project with onboarding tips 不是玩具，而是唯一一个把提示嵌进编辑器实时触发的引导机制。它会在你输入 console.log 后弹出快捷修复、在写 CSS 时高亮显示可补全属性——这些提示只在 Playground 项目里默认开启。
但它的局限也很明显：所有提示都基于静态规则，不理解你真实项目的构建流程（比如 Vite 或 Webpack 配置）。一旦你新建了 React/Vue 模板项目，那些友好提示就消失了，因为 IDE 切换到了“框架感知模式”，转而依赖 node_modules 和配置文件做推断。
- 建议用 Playground 过一遍基础操作（Emmet、Ctrl+Space 补全、Alt+Enter 快修），再新建真实项目
- Playground 项目生成后，别在里面写业务逻辑——它没有
package.json，没法装依赖，也不能跑npm start - 想长期保留提示体验？可以复制 Playground 里的
.editorconfig和部分.idea/inspectionProfiles到自己项目里，但别直接挪整个.idea
