使用远程Docker解释器时如何禁止PyCharm索引remote_sources文件夹

适用版本：PyCharm专业版2021.2.1，远程Python 3.9.6 Docker环境

方案1：全局禁用远程源自动下载（推荐） #

直接从IDE层面关闭远程源拉取逻辑，从根源避免索引触发：

• 打开PyCharm，点击顶部菜单栏 帮助 > 编辑自定义VM选项
• 在打开的vmoptions配置文件末尾追加一行参数：

  -Djetbrains.python.remote.sources.download.enabled=false
  

• 保存配置后重启PyCharm即可生效，该配置不会影响正常的代码补全、调试功能，仅会取消不必要的远程源代码拉取和索引。

方案2：路径映射后手动排除 #

如果需要保留部分远程源下载功能，可通过路径映射实现手动排除：

• 打开PyCharm的远程解释器配置页，找到 路径映射 配置项
• 新增一条映射规则：
  • 远程路径：~/.cache/JetBrains/remote_sources（请替换为实际的完整绝对路径）
  • 本地路径：任意本地空文件夹路径，例如C:\pycharm_empty_dir或者/home/xxx/pycharm_empty_dir
• 打开 文件 > 项目结构，找到上述映射的本地空文件夹，右键标记为 已排除，保存配置后重启IDE即可。

方案3：修改Docker镜像的缓存路径 #

在自定义Docker镜像中修改JetBrains远程缓存的默认存储位置，指定到IDE默认不索引的临时目录：

• 编辑你的Dockerfile，追加以下环境变量配置：

  ENV JETBRAINS_REMOTE_SOURCES_CACHE_DIR=/tmp/jetbrains_remote_cache
  

• 重新构建镜像后使用新镜像启动容器即可，/tmp 目录下的内容默认不会被PyCharm拉取索引，且容器重启后会自动清空缓存，不会占用额外存储。

生效验证 #

配置完成后，可先删除远程容器内已生成的$HOME/.cache/JetBrains/remote_sources目录，重启PyCharm重新连接远程解释器，确认该目录不再重新生成、无额外索引任务触发即可。

内容的提问来源于stack exchange，提问作者David Taub