WebStorm新手三大问题5分钟内可解：一是项目打不开因路径含中文/空格或node_modules未排除；二是代码提示失效因文件类型识别错误或JS/TS版本未配置；三是Git push失败因HTTPS密码认证过时，应改用SSH或Gitee插件OAuth。
WebStorm 新手最常卡在三件事上：项目打不开、编辑器卡顿、Git 推不上去。这些问题基本都能在 5 分钟内定位并解决，不需要重装或查文档半天。
项目启动失败或根本打不开？先看安装路径和 node_modules
启动失败、插件装不上、新建项目没反应——90% 是因为安装路径含中文或空格。WebStorm 的 JVM 启动器对非 ASCII 字符极其敏感，哪怕路径里有个「我的」都会导致 Failed to load JVM 错误。
另一个高频原因是项目里有未排除的 node_modules。IDE 默认索引全部文件，一万个 JS 文件会让内存爆表、CPU 拉满，表现为：右键菜单延迟、搜索卡住、自动补全失效。
- 卸载后重装到纯英文路径，例如
C:\dev\webstorm或/Users/you/dev/webstorm - 打开已有项目后，右键点击
node_modules文件夹 → 【将目录标记为】→ 【排除】 - 如果已生成
.idea配置但项目异常，可直接删掉该文件夹再重启 WebStorm（它会自动重建）
代码写不快、提示不弹、Ctrl+Space 没反应？检查语言服务状态
不是所有文件类型默认启用智能提示。比如你新建一个 script.js 放在根目录，WebStorm 可能把它识别为普通文本，而不是 JavaScript 文件——这时连基础的 console.log 补全都不会出现。
还有更隐蔽的情况：项目没配 JavaScript language version，或者用了 TypeScript 但没开 tsconfig.json 支持，也会让类型推导完全失效。
- 右键文件 → 【Override File Type】→ 确保是
JavaScript或TypeScript - 进入
Settings/Preferences → Languages & Frameworks → JavaScript，确认版本选的是ES6+或对应项目需求 - 如果有
tsconfig.json，确保它在项目根目录，且没有语法错误（WebStorm 会在底部状态栏标出 TS Server 状态）
Git 提交成功但 push 报错 Authentication failed？别输密码
WebStorm 默认用系统 Git，但 Gitee/GitHub 的 HTTPS 认证早就不支持明文密码了。你在弹窗里输密码，一定会失败，还可能被记进系统凭据管理器，后续更难清理。
真正该走的路径是：用 SSH 密钥，或用 Gitee 官方插件 + OAuth 令牌。前者通用，后者对国内用户更稳。
- 生成 SSH 密钥：
ssh-keygen -t ed25519 -C "your_email@example.com"，然后把公钥贴到 Gitee / GitHub 的 SSH 设置页 - 在 WebStorm 中，
VCS → Git → Remotes，把远程地址从https://...改成git@gitee.com:username/repo.git - 如果坚持用 HTTPS，务必安装
Gitee插件（Settings → Plugins → Marketplace 搜），绑定账号后 push 自动走 OAuth，不弹密码框
调试按钮灰色、Chrome 不弹、断点不生效？检查运行配置
WebStorm 的调试功能依赖明确的「运行配置」。很多人点了右上角的甲虫图标，结果提示 No run configuration 或直接静默失败——因为 IDE 根本不知道你要用什么方式跑这段 JS。
尤其当你写的是纯 HTML + 内联 JS，而不是 Node.js 服务，必须手动指定浏览器环境，否则它默认找 Node 解释器，当然找不到。
- 点击右上角绿色三角旁的下拉箭头 → 【Edit Configurations…】→ 左上角加号 → 选择
JavaScript Debug - URL 填本地路径，例如
file:///path/to/your/index.html（注意是三个斜杠） - 确保 Chrome 已安装且 WebStorm 能检测到：Settings → Tools → Web Browsers，勾选对应浏览器
最后提醒一句：WebStorm 的「排除目录」只影响索引，不影响编译或构建；而「标记为源根」（Mark as Sources Root）才会影响模块解析路径。这两个操作看着像，作用完全不同，新手容易混用。
