webstorm导出设置前必须打开项目,否则“file | export settings”按钮灰色不可用;导出zip仅含code style、live templates、keymap等ide层配置,不包含插件、vcs账号及registry开关,导入后需重启ide并手动切换方案才生效。

导出旧版WebStorm设置前必须打开项目
否则 File | Export Settings 按钮始终灰色不可点——这是新手最常卡住的第一步。WebStorm 的导出逻辑依赖项目上下文,哪怕只新建一个空文件夹、用“Open”方式打开它,也足以激活导出功能。
导出时默认勾选全部,但实际有效项有限:Code Style、Live Templates、Keymap、Editor Colors & Fonts 这几类能真正迁移;而 Plugins 列表、VCS accounts(如 GitHub token)、Registry 里的实验开关,不会被打包进 ZIP。
- 推荐选 ZIP 格式:轻量、路径无关、无版本绑定,比 JAR 更稳妥
- 别直接复制整个
config目录:含硬编码路径、临时缓存、workspace.xml 等项目级文件,导入后易冲突或报错 - 导出路径建议选桌面或文档目录,避免中文或空格路径导致解压失败
导入后不生效?先关掉再重开
点击 Import Settings → 选 ZIP → 点 OK,只是把配置解压进 config 目录,**不是立即生效**。必须彻底退出 WebStorm(macOS 上要确认进程已结束,Windows 可查任务管理器),再重新启动。
导入是“合并”,不是覆盖:比如你本地已有 2 条 Live Templates,导入包里有 5 条,最终就是 7 条;但同名模板会被新内容替换。
- 主题/字体/行号开关等 UI 类设置,重启后才加载;不重启就只能看到 Keymap 切换框里多了一个选项,但没激活
- 导入后进
Settings/Preferences → Keymap,顶部下拉框手动选中刚导入的方案,否则仍用旧快捷键 - 如果用了 JetBrains Account 同步,需先在
Settings Sync页面点Push Settings to Account,否则云端仍是空的
恢复默认设置时备份在哪
用 File | Manage IDE Settings | Restore Default Settings 会自动把当前配置打包存到备份目录,路径固定:
Windows:%APPDATA%\JetBrains\WebStorm<version>-backup</version>
macOS:~/Library/Caches/JetBrains/WebStorm<version>-backup</version>
Linux:~/.cache/JetBrains/WebStorm<version>-backup</version>
- 这个备份可随时用于
Import Settings,比手动记插件名或截图更可靠 - 但注意:备份不含已安装插件本身,只含启用/禁用状态;重装后仍需去
Plugins页面搜索并安装 - 若想保留某套配色,单独导出
.icls文件更安全——进Settings → Editor → Color Scheme,点Export即可
换电脑后插件和账号得单独处理
ZIP 导入或 Settings Sync 都不带插件二进制文件和 VCS 凭据。这意味着:
插件要重装:Settings → Plugins 里搜名称,或从备份目录的 plugins/ 子目录手动复制(仅限兼容版本);GitHub 账号、SSH key、Git credential helper 这些全得重新登录或配置。
- Settings Sync 插件默认开启,但有人为省资源关过,导入后先检查是否启用
- Toolbox 登录 ≠ WebStorm 登录:进
Settings → Settings Sync页面,右上角必须显示邮箱才算真正绑定 - Registry 里的开关(如
ide.suppress.double.click.handler)从不随 ZIP 或 Sync 迁移,换机后得手动重设











