适用读者：环境被折腾坏想重装的人；换电脑/重装系统后不想重新配三天的人。
前置：S01-B04（设置分层：个人偏好 / 团队约定 / 机器相关）。
实测环境：IDEA 2025.x 目录约定（官方文档口径）；本文标注「方法」的步骤可复现但未在本机跑基准。
覆盖旧文：A-1350（彻底卸载 IDEA，50 点）、A-1366（导入导出配置，31 点）、A-1378（清理缓存，18 点）= 99 点。
新增扩展：E-S01-011（Settings Repository 与 dotfiles）。
上一篇：S01-B08 · Vim 生存手册：17 个高频动作
下一篇：S01-B10 · Git 入门。
1. 一句话结论
IDE 的数据分四类，各在各的目录：配置（config）、缓存（caches）、插件（plugins）、日志（logs）。"重装"之所以经常不彻底，是因为只卸了程序本体，没动这四类；"迁移"之所以经常失败，是因为把四类混为一谈——缓存不该搬，配置必须搬。
| 类别 | 内容 | 重装时 | 迁移时 |
|---|---|---|---|
| config | 设置、键位、代码风格、Live Templates、工具窗布局 | 想彻底重置就删 | 必须搬 |
| caches | 索引、本地历史、编译缓存 | 删（会重建） | 绝不搬（搬了极易报错） |
| plugins | 已安装插件本体 | 与程序一起清 | 由配置里的插件清单重建（不搬二进制） |
| logs | idea.log 等 |
删 | 不搬（排障时才有用） |
2. 四类数据在哪
| 平台 | config | caches | plugins | logs |
|---|---|---|---|---|
| Windows | %APPDATA%\JetBrains\IntelliJIdea2025.x |
%LOCALAPPDATA%\JetBrains\IntelliJIdea2025.x |
%APPDATA%\JetBrains\IntelliJIdea2025.x\plugins |
同 caches 下的 log |
| macOS | ~/Library/Application Support/JetBrains/IntelliJIdea2025.x |
~/Library/Caches/JetBrains/IntelliJIdea2025.x |
同 config 下 plugins |
~/Library/Logs/JetBrains/IntelliJIdea2025.x |
| Linux | ~/.config/JetBrains/IntelliJIdea2025.x |
~/.cache/JetBrains/IntelliJIdea2025.x |
同 config 下 plugins |
同 caches 下 log |
最快找到路径的方法（不依赖记路径）：
Help → Diagnostic Tools → Show Log in Files → 打开 logs 目录
Help → Edit Custom VM Options → 打开 config 目录（同级的上一层）
版本号目录名随 IDE 版本变化（
IntelliJIdea2025.1这类）。升级大版本后配置不会自动继承，这是"升级后设置全没了"的真相。
3. 彻底卸载：三步，不是一步
3.1 Windows
设置 → 应用 → 已安装的应用 → IntelliJ IDEA → 卸载- 删残留目录（对照 §2 的四类路径）：
Remove-Item -Recurse -Force "$env:APPDATA\JetBrains\IntelliJIdea2025.*" Remove-Item -Recurse -Force "$env:LOCALAPPDATA\JetBrains\IntelliJIdea2025.*" - 检查注册表残留（可选）：
HKCU\Software\JavaSoft、HKCU\Software\JetBrains。不熟注册表就别动，一般不影响重装。
3.2 macOS
- 退出 IDEA（
⌘Q），把/Applications/IntelliJ IDEA.app拖到废纸篓。 - 删配置与缓存：
rm -rf ~/Library/Application\ Support/JetBrains/IntelliJIdea2025.* rm -rf ~/Library/Caches/JetBrains/IntelliJIdea2025.* rm -rf ~/Library/Logs/JetBrains/IntelliJIdea2025.* rm -rf ~/Library/Preferences/com.jetbrains.intellij.plist # 可选 - 别删
~/Library/Application Support/JetBrains/Toolbox（如果你用 Toolbox 管理多版本）。
3.3 Linux
# tar.gz 安装：删安装目录即可
sudo rm -rf /opt/idea-IU-*
# 配置与缓存
rm -rf ~/.config/JetBrains/IntelliJIdea2025.*
rm -rf ~/.cache/JetBrains/IntelliJIdea2025.*
# snap 安装
sudo snap remove intellij-idea-ultimate
3.4 卸载后自检
| 检查 | 命令/动作 | 预期 |
|---|---|---|
| 无进程残留 | ps aux | grep -i idea |
无输出 |
| 无配置残留 | ls ~/.config/JetBrains |
空目录或不存在 |
| 重装后是"全新"状态 | 启动 → 不再弹"导入旧设置" | 向导从零开始 |
4. 清缓存：Invalidate Caches 到底清了什么
路径：File → Invalidate Caches…
| 选项 | 清什么 | 什么时候勾 |
|---|---|---|
Clear file system cache and Local History |
文件系统缓存 + 本地历史（Local History 是不可恢复的！） |
只在怀疑缓存损坏时；勾之前先确认没有"只存在于 IDE 里"的改动 |
Clear VCS Log caches and indexes |
Git 日志索引 | 日志面板显示异常时 |
Ask before deleting |
删除前确认 | 建议保持开启 |
典型使用场景（旧文 A-1378 只说了"卡了就清"，没说边界）：
- 项目全红但命令行编译通过 → 先试
Maven → Reload，无效再清缓存 - 升级 IDE 大版本后符号解析错乱 → 清缓存
- 插件卸载/安装后出现幽灵报错 → 清缓存
代价：清完要重建索引，大工程可能几分钟。这不是"日常维护动作"，是有症状才用的手段。
5. 配置搬家：三条路径，按团队规模选
5.1 路径一：Export Settings（单人、一次性）
File → Manage IDE Settings → Export Settings… → 生成 settings.zip
File → Manage IDE Settings → Import Settings… → 在新机器导入
包含：设置、键位、代码风格、Live Templates、工具窗布局、部分插件配置。
不包含：JDK 路径、Maven 本地仓库路径、Git 可执行文件路径（这些是"机器相关"，见 S01-B04 §1）、插件二进制本体。
导入后必做：
Project SDK与Maven路径重新指向本机（否则一片红）。
5.2 路径二：Settings Sync（多机、有 JetBrains 账号）
File → Manage IDE Settings → Settings Sync… → 登录 JetBrains Account → 选择同步内容
优点：自动、增量、可关掉敏感项（如插件列表）。
风险：配置进第三方云。公司环境里先确认安全策略是否允许。
5.3 路径三：Settings Repository（团队、Git 化）
File → Manage IDE Settings → Settings Repository… → 填 Git 仓库地址
把配置放进一个 git 仓库，多人共享同一套"团队约定"（对照 S01-B04 §5 的 Code Style XML）。适合有明确规范的团队，这也是 S01-A01（Onboarding 标准化）的一块拼图。
5.4 dotfiles：把"机器相关"也变成可重建
配置搬家只解决 IDE。环境迁移的完整版是 dotfiles 仓库：
~/dotfiles/
├── .zshrc / .bashrc # PATH、别名、starship
├── .gitconfig # user.name/email、别名（B10、J03）
├── .ssh/config # Host 别名（B11）
├── .editorconfig # 团队格式约定
├── Brewfile # macOS：brew bundle 一键装齐
├── packages.config # Windows：choco install packages.config -y
└── install.sh # 软链到 $HOME 的脚本
macOS 一键恢复：
brew bundle install --file=~/dotfiles/Brewfile
Windows 一键恢复：
choco install ~/dotfiles/packages.config -y
Linux：一份 apt list --installed 快照 + 一个 install.sh 就够（别指望完全自动化）。
dotfiles 的判据：新机器上，
git clone dotfiles && ./install.sh之后，能不能直接开工。做不到就说明还有"只存在于你脑子里"的步骤。
6. 迁移验收：15 分钟复原清单
| # | 项 | 命令/动作 | 通过标准 |
|---|---|---|---|
| 1 | 基础工具 | git -v、mvn -v、java -version |
三处版本与基线一致 |
| 2 | shell 环境 | 新开终端 | 别名、PATH、提示符都在 |
| 3 | SSH | ssh blog 'echo ok' |
免密连通 |
| 4 | Git 身份 | git config --global user.name |
非空且正确 |
| 5 | IDE 配置 | 打开 IDEA | 主题/字号/键位/模板与旧机一致 |
| 6 | IDE 工程 | 打开任一项目 | 依赖可解析（Reload Maven 后无红） |
| 7 | 验证"可重建" | 换一台干净机器照做一遍 | 全程无需回忆步骤 |
第 7 条是唯一的硬标准。"我记住了"不算可重建，"文档/脚本里有"才算。
7. 旧文对照
| 旧文 | 内容 | 本篇处理 |
|---|---|---|
| A-1350 | 如何彻底卸载 IDEA（图文，偏 Windows 控制面板路径） | §3 重写为三平台，并给出四类数据路径表（旧文只有"删安装目录+删配置"两步，缺 caches/logs 的区分） |
| A-1366 | 导入导出所有配置（settings.zip） | §5.1 保留，补"不含什么"（JDK/Maven/Git 路径、插件本体）——这是迁移后"一片红"的真正原因 |
| A-1378 | 清理缓存 | §4 保留动作，补边界：Local History 会被删、清完要重建索引、不是日常动作 |
| — | 没有 dotfiles / Settings Repository | 新增 §5.3、§5.4（E-S01-011） |
| — | 没有"迁移验收"标准 | 新增 §6 的 15 分钟清单，把"可重建"作为唯一硬标准 |
8. 自测
- 升级 IDEA 大版本后设置全没了，最可能的原因是什么？
Invalidate Caches里勾了Clear Local History会丢什么？什么情况下不该勾？- 迁移后项目一片红，但
mvn -q compile成功，最可能漏了哪一步？ - 为什么 config 要搬、caches 不能搬？
- 你的 dotfiles 里放
Brewfile而不放/opt/homebrew整个目录，理由是什么？
9. 下一篇
S01-B10 · Git 入门：安装、账户、SSH、克隆与提交
环境能重建了，下一步是让代码可追溯。下一篇从"第一次 git push 被拒"这个真实场景切入，把 user.name/email、SSH 密钥、clone/commit/push 讲成一条闭环，并给出被拒时的三种定位路径。
本篇属于系列《S01 · 开发环境与工具链》。旧文来源：A-1350/1366/1378；扩展点 E-S01-011。点位映射见 ../coverage.csv。