idea.system.path 是 pycharm 存放缓存、索引、本地历史等运行时临时数据的目录,非项目路径;windows 默认位于 appdata\local\jetbrains\pycharmxxxx.x,易占满 c 盘;需通过修改 idea.properties 文件(安装目录 bin/ 或自定义配置路径下)显式设置并重启生效;迁移需手动复制完整 system 目录结构,否则可能引发索引或模块加载异常;建议同步配置 idea.log.path 并定期清理 localhistory。

PyCharm 的 idea.system.path 是什么
PyCharm 启动后生成的缓存、索引、本地历史(Local History)、临时编译产物等,都默认存放在 idea.system.path 指向的目录里。它不是“新建文件”的保存位置,也不是项目路径——而是 IDE 自身运行时产生的临时数据存放地。Windows 上 2020 年后默认是 ${user.home}\AppData\Local\JetBrains\PyCharmXXXX.X,容易把 C 盘撑爆。
修改 idea.system.path 的两种可靠方式
必须改配置文件,Settings 里没有这个选项。只有两个实际生效的方法:
- 编辑
idea.properties文件:找到 PyCharm 安装目录下的bin/idea.properties,取消注释并修改idea.system.path行,例如:idea.system.path=D:/pycharm_cache/system - 用 Help → Edit Custom Properties:PyCharm 运行中调出该菜单,会自动在
idea.config.path下创建或打开idea.properties;但注意——它只影响配置路径,idea.system.path必须显式写入才能生效
改完必须重启 PyCharm,否则不加载新路径。
迁移旧缓存前先停用旧路径
直接改路径后启动,PyCharm 会新建空缓存目录,但旧索引、历史记录就丢了。要保留数据就得手动迁移:
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- 关掉 PyCharm
- 把原
idea.system.path目录(比如C:\Users\XXX\AppData\Local\JetBrains\PyCharm2025.2\system)整个复制到新路径对应位置 - 确保新路径下目录结构完整(如含
compile-server、caches、localHistory等子目录) - 不要只复制部分子目录——缺一个可能导致索引异常或无法加载历史版本
如果复制后启动报错 “Cannot load project: cannot read module info”,大概率是 caches 或 compiler 子目录权限/损坏,删掉这两个再重开,PyCharm 会重建。
别漏掉 idea.log.path 和磁盘空间监控
idea.system.path 改了,日志默认仍写进 system 目录下 log 子目录。如果你把 system 路径挪到小容量盘,建议一并设置:
idea.log.path=D:/pycharm_cache/log
另外,PyCharm 不会自动清理旧日志和缓存,尤其 localHistory 可能占数 GB。定期手动清空 system/localHistory 或在 Settings → System Settings → Synchronization 中调低 “Keep local history for (days)” 值(默认 5 天,设成 1–2 更稳妥)。










