JetBrains 系列软件在 Windows 下的目录结构整理

装完 IDEA、PyCharm、GoLand 之后，设置、插件、快捷键、索引缓存、日志这些东西到底存在哪？重装系统或换机器时该备份哪些目录？本文整理 Windows 环境下 JetBrains 系列 IDE 的各类目录默认位置与用途。

一、四类目录总览

这里有个容易混淆的关键点：%APPDATA%（Roaming）放配置，%LOCALAPPDATA%（Local）放缓存。两者是同一个 AppData 下的不同子目录，不要看混。

%APPDATA%       = C:\Users\<用户名>\AppData\Roaming
%LOCALAPPDATA%  = C:\Users\<用户名>\AppData\Local
%ProgramFiles%  = C:\Program Files

二、安装目录

用独立安装包安装

从官网下载 exe 安装包安装时，默认落在：

C:\Program Files\JetBrains\IntelliJ IDEA 2024.1\

用环境变量写就是 %ProgramFiles%\JetBrains。

如果需要在命令行或脚本里用 8.3 短路径规避空格问题，同一个目录也可以写成：

C:\Progra~1\JetBrains

用 Toolbox 安装

通过 JetBrains Toolbox 安装的 IDE 不在 Program Files 下，而是在用户目录里，且默认位置隨 Toolbox 版本变过：

Toolbox 2.1 起可以在 设置 → Tools → Tools install location 里改安装位置。但要注意：改动只对之后新装的 IDE 生效，之前装好的不会自动迁移，需要自己重装。

另外，Toolbox 安装的 IDE 默认不改系统 PATH、也不建桌面快捷方式。想在命令行直接敲 idea64.exe，得手动把它的 bin 目录加进 PATH。

三、配置目录（设置 / 插件 / 快捷键）

%APPDATA%\JetBrains\<产品><版本>\

# 展开后，例如 IDEA 2024.1：
C:\Users\<用户名>\AppData\Roaming\JetBrains\IntelliJIdea2024.1\

# 用 8.3 短名写（Administrator 会被截断为 Admini~1）：
C:\Users\Admini~1\AppData\Roaming\jetbrains\

最后一行里的 jetbrains 小写同样有效——Windows 路径不区分大小写。

常用子目录

产品代号对照

目录名里的 <产品><版本> 使用产品内部代号，不同产品、不同版本都不一样：

注意版本号后缀：升级 IDE 大版本后目录名会变（如 IntelliJIdea2024.1 → IntelliJIdea2024.2），旧目录不会自动删除。这也意味着不同大版本之间的配置是各自独立的。

四、缓存与索引目录

%LOCALAPPDATA%\JetBrains\<产品><版本>\

# 例如：
C:\Users\<用户名>\AppData\Local\JetBrains\IntelliJIdea2024.1\

主要包含：

• caches\ — 各类缓存
• index\ — 项目索引
• log\ — IDE 运行日志，排查启动 / 崩溃问题看这里
• tmp\ — 临时文件

这个目录通常是占用空间最大的，几十 GB 很常见。整个目录可以直接删除，IDE 下次启动会自动重建（代价是首次打开项目要重新建索引，会慢一阵）。这是清理磁盘空间的首选操作。

五、目录布局的历史变化（2020.1 是分水岭）

如果你的机器上看到 .IntelliJIdea2019.3 这类以点开头的目录，那是旧版布局的残留：

旧版本的 config 和 system 都在用户主目录下的同一个文件夹里；2020.1 起拆成了 Roaming（配置）和 Local（缓存）两处。

清理旧残留可以用 IDE 内置的功能：Help → Delete Leftover IDE Directories，或在 Toolbox 里一并清理。

六、常用操作

查看 8.3 短路径名

想知道某个目录的短名是什么，用 dir /x 让资源管理器把短名列出来：

dir /x C:\
dir /x C:\Users

常见的对应关系：Program Files → Progra~1，Administrator → Admini~1。

备份与迁移配置

换机器时，要备份的是两个目录，只拷一个会丢东西：

1. %APPDATA%\JetBrains\<产品><版本> — 设置、插件、快捷键
2. %LOCALAPPDATA%\JetBrains\<产品><版本> — 缓存与日志（可不拷，IDE 会重建）

只想带走设置和插件的话，拷第一个就够了。

自定义目录位置

如果 C 盘空间紧张，可以改 idea.properties 把配置和缓存挪到别的盘：

idea.config.path= D:/JetBrains/config
idea.system.path= D:/JetBrains/system
idea.plugins.path= D:/JetBrains/plugins
idea.log.path= D:/JetBrains/log

注意事项：

• 路径要用正斜杠 /，不要用反斜杠
• 不要把不同属性指向同一个目录

恢复默认设置

File → Manage IDE Settings → Restore Default Settings 可以把 IDE 恢复到初始状态。执行时会自动把原配置备份到一个带 -backup 后缀的目录（如 IntelliJIdea2024.1-backup），不会直接丢。

七、快速速查卡

安装目录   : %ProgramFiles%\JetBrains            （短名 C:\Progra~1\JetBrains）
配置目录   : %APPDATA%\JetBrains\<产品><版本>     （Roaming，设置/插件/快捷键）
缓存目录   : %LOCALAPPDATA%\JetBrains\<产品><版本>（Local，索引/缓存/日志，可直接删）
Toolbox    : %LOCALAPPDATA%\JetBrains\Toolbox
Toolbox IDE: %LOCALAPPDATA%\Programs             （2.0+；2.0 之前在 Toolbox\apps）
旧版残留   : %USERPROFILE%\.<产品><版本>         （2020.1 之前的布局）

用户名展开 : Administrator → Admini~1
查看短名   : dir /x C:\

本文基于 JetBrains 官方帮助文档与实际安装环境整理，不同版本、不同安装方式下路径可能略有差异，请以本机实际情况为准。