最直接方式是右键目标文件夹→选择Reformat Code；若菜单灰色，需确认是否为Sources Root或非源码目录。
用 Project 视图右键菜单批量格式化文件夹
最直接的方式是：在左侧 Project 工具窗口中，找到目标文件夹，右键 → 选择 Reformat Code。WebStorm 会立即弹出 Reformat Files 对话框，列出该目录下所有匹配的源文件（默认按当前语言代码风格过滤）。
常见错误现象：Reformat Code 菜单项灰色不可点？通常是因为你右键点到了非源码目录（比如 node_modules、dist），或该目录未被识别为“Sources Root”。可右键目录 → Mark Directory as → Sources Root 临时修复。
实操建议：
- 勾选
Optimize imports：自动删无用 import、补缺失 import、按字母/路径排序（对 TypeScript/JavaScript 尤其实用） - 慎用
Do not keep line breaks：它会强制重写所有换行，可能破坏你手动加的空行逻辑（比如分组注释、视觉区块） - 如果只想处理某类文件，点击对话框右上角
Filter，输入*.ts或!*.test.ts排除测试文件
命令行 format 命令适合 CI 或大范围清理
当文件夹层级深、文件多，或需要在脚本中复用时，WebStorm 自带的命令行工具比 GUI 更可控。启动终端，执行：
webstorm64.exe format --settings-path "C:\path\to\your\.idea" src\components
注意路径必须是绝对路径，且 webstorm64.exe 需在系统 PATH 中，或使用完整安装路径（如 "C:\Program Files\JetBrains\WebStorm 2025.3\bin\webstorm64.exe"）。
容易踩的坑：
-
--settings-path指向的是项目.idea目录，不是.editorconfig—— WebStorm 命令行格式化默认读取 IDE 的Code Style设置，而非.editorconfig - 不支持通配符递归（如
src/**/*.ts），只能指定目录；若需过滤，得配合--include或--exclude参数 - macOS/Linux 用户请用
webstorm.sh替代webstorm64.exe
为什么 .editorconfig 在文件夹级格式化中有时“不生效”
WebStorm 对 .editorconfig 的加载是路径敏感的：它只从**每个被格式化文件的最近上级目录**中查找 .editorconfig。也就是说，如果你在 src/components 右键格式化，但 .editorconfig 只放在项目根目录，那没问题；但若你在 src/components/ui 文件夹里又放了一个 .editorconfig，那么 ui 下的文件就会优先用它。
关键判断点：
-
.editorconfig只控制基础项：缩进风格、换行符、末尾空格等，**不控制分号、括号位置、运算符空格**——这些仍由Settings > Editor > Code Style > [Language]决定 - 如果发现格式化结果和
.editorconfig不一致，先检查 IDE 是否启用了Enable EditorConfig support（Settings > Editor > Code Style > ☑ Enable EditorConfig support） - 插件如 Prettier 或 ESLint 启用后，会绕过
.editorconfig和内置 Code Style，直接走自身规则——此时右键Reformat Code实际调用的是 Prettier，不是 IDE 引擎
别忽略 “Only if file is physically modified” 这个开关
这个选项藏在 Settings > Tools > Actions on Save 里，但它会影响整个项目的批量格式化行为：如果勾选了它，而你又通过脚本或外部工具（比如 Git hook）修改了文件内容但没触发 IDE 的“脏标记”，那么即使你右键 Reformat Code，WebStorm 也可能跳过那些文件——因为它内部判定“这文件没变过”。
真实场景中容易被忽略的地方：
- 用
git checkout切分支后立刻右键格式化，部分文件可能被跳过 - 从命令行执行
webstorm64.exe format时，该设置不生效（它是 UI 层行为），但本地 GUI 批量操作时它就起作用 - 团队协作中，有人开了这个开关，有人没开，会导致同一份
.editorconfig在不同人机器上格式化结果不一致
