推荐卸载旧版+清理残留+安装新版；jetbrains toolbox可一键平滑升级，自动同步授权、继承设置插件；直接覆盖安装易致插件失效、索引异常等问题。
不用卸载重装也能更新，但想彻底干净、避免配置错乱或插件失效，推荐卸载旧版 + 清理残留 + 安装新版。JetBrains Toolbox 是唯一能真正“一键平滑升级”的方案，其他方式都绕不开手动干预。
用 JetBrains Toolbox 自动更新（最省心）
Toolbox 不是可选插件，是 JetBrains 官方推出的版本管理器，它把 PyCharm 当成一个“服务”来维护：
- 自动检测新版本并弹窗提醒，点击
Update即开始下载安装 - 安装后旧版本仍保留在磁盘上，可随时切换回 2024.3 或 2025.1，无需重装
- 许可证自动同步，登录 JetBrains Account 后所有授权即刻生效
- 设置、插件、快捷键全部继承，不弹“导入旧设置”向导——因为根本没中断过上下文
注意：Toolbox 默认安装路径在 %LOCALAPPDATA%\JetBrains\Toolbox（Windows）、~/Library/Application Support/JetBrains/Toolbox（macOS），首次运行会自动拉取你账户下已购/教育许可的 IDE 列表。
手动升级：卸载 + 清理 + 重装（稳妥但需动手）
直接覆盖安装或双击新安装包，大概率导致 Settings → Plugins 里一堆灰色禁用项、File → Manage IDE Settings → Export Settings 导出失败、甚至启动时报 java.lang.NoClassDefFoundError。必须清理三类残留：
-
%APPDATA%\JetBrains\PyCharm202x.x和%LOCALAPPDATA%\JetBrains\PyCharm202x.x（Windows）；~/Library/Caches/JetBrains/PyCharm202x.x、~/Library/Application Support/JetBrains/PyCharm202x.x（macOS）；~/.cache/JetBrains/PyCharm202x.x、~/.config/JetBrains/PyCharm202x.x（Linux） - 注册表项（仅 Windows）：
HKEY_CURRENT_USER\Software\JetBrains\PyCharm202x.x - 项目级缓存（可选但推荐）：
.idea目录下部分二进制文件（如workspace.xml可留，caches子目录建议删）
清理完再运行新安装包，安装向导中勾选 Import settings from previous version，它会自动扫描残留目录并还原，比手动导入 pycharm-settings.zip 更可靠。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
项目 Python 环境要重新绑定（容易漏掉的关键一步）
新版 PyCharm 对虚拟环境识别逻辑有调整，尤其涉及 venv vs .venv、poetry 的 .venv 路径、uv 的 .venv 位置。常见现象：
- 打开老项目后，
Python Interpreter显示为None或灰色不可用 - 终端里
which python指向系统 Python，而非项目虚拟环境 - 运行时提示
ModuleNotFoundError，尽管pip list显示包已安装
解决方法：进入 Settings → Project → Python Interpreter，点击右上角齿轮 → Add... → 选择 Existing environment → 手动定位到你的虚拟环境 python.exe（Windows）或 bin/python（macOS/Linux）。若用 poetry，路径通常是 ~/.cache/pypoetry/virtualenvs/xxx-py3.x；若用 uv，默认在项目根目录下的 .venv/bin/python。
为什么不能跳过清理直接覆盖安装？
PyCharm 的配置目录（JetBrains 下的子文件夹）不是纯 JSON，包含大量编译缓存、索引快照、插件二进制状态文件。2024.x 和 2026.x 的 indexing format 不兼容，强行复用会导致：
- 项目打开极慢，CPU 持续 100%，
Scanning files to index...卡住数分钟 -
Find in Path失效，搜索不到刚写的函数名 - 代码补全偶尔失灵，明明 import 了却标红
- 某些插件（如
Database Tools、Remote Dev）启动报PluginException: incompatible with current IDE version
这些不是重启能解决的，必须清空对应版本号的缓存目录。最省事的办法，就是别图快——多花 3 分钟手动删掉 PyCharm202x.x 文件夹，比后面花 3 小时排查索引异常值得多。
