pycharm 的 local history 自动保存本地文件修改快照，不依赖 git，用于恢复误删代码、ide 自动改动或被 git checkout 覆盖的未提交变更；仅对 pycharm 索引的文件生效，支持时间轴查看、多版本对比和关键词搜索。
Local History 在 PyCharm 里存的是什么
PyCharm 的 Local History 不依赖 Git，而是自动记录你本地文件的修改快照（默认每分钟、每次显式保存、每次运行/调试前都会存）。它不是版本控制系统，但能帮你找回误删的代码、撤销 IDE 自动改动（比如格式化或重命名引发的连锁修改），甚至恢复被 git checkout -- 覆盖掉的未提交变更。
关键点：它只对项目中已加入 PyCharm 索引的文件生效（即显示在 Project 工具窗口里的文件），新建但未保存的临时文件、外部修改的文件（比如用 VS Code 改了再切回 PyCharm）可能不会立即被捕获。
怎么打开和筛选 Local History 记录
右键点击文件或目录 → 选择 Local History → Show History。窗口左侧是时间轴，右侧是 diff 面板。
PyCharm 2026.2
下载
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
- 时间戳靠右的条目通常是手动触发的（如执行
Ctrl+Shift+K提交前的快照），靠左的是自动保存点 - 可以按住
Ctrl（Windows/Linux）或Cmd（macOS）多选多个历史版本做对比 - 右上角搜索框支持按修改内容关键词过滤（比如搜
def parse_找某次函数重命名前的状态） - 注意：
Revert是覆盖当前文件，Copy Path from Here才能导出某个历史版本的完整路径供比对
为什么有些修改没出现在 Local History 里
常见原因不是功能失效，而是触发条件不满足：
- 文件未被 PyCharm 管理：比如放在
venv/或__pycache__/目录下，PyCharm 默认忽略这些路径 - 修改由外部工具触发且未触发重载：例如用命令行
sed -i改了文件，但 PyCharm 没检测到磁盘变更（可手动File → Reload project from Disk） - Local History 被手动关闭：检查
Settings → Appearance & Behavior → System Settings → Local History，确认Keep history for天数 > 0 且勾选了Enable local history - 磁盘空间不足：PyCharm 会静默丢弃旧快照，日志里会有
LocalHistory: disk space limit exceeded提示（查Help → Show Log in Explorer）
Local History 和 Git 历史冲突时优先用哪个
两者完全独立，不存在“优先级”。但操作逻辑不同：
- Git 历史反映的是你
commit过的内容，适合跨人协作回溯；Local History 反映的是你本地编辑器的操作痕迹，适合救急 - 如果刚执行了
git reset --hard又发现删错了，立刻看 Local History —— 它不受 Git 操作影响 - 如果在 PyCharm 里点了
VCS → Git → Revert，那是 Git 层面的撤销；而右键 →Local History → Revert是 IDE 层面的覆盖，二者互不干扰 - 注意：Local History 的快照不包含分支信息、提交消息，也不支持 cherry-pick 类操作
真正容易被忽略的是时间精度——Local History 默认最小粒度是秒级，但同一秒内多次保存只会保留最后一次，高频手动保存（比如狂按 Ctrl+S）反而可能覆盖掉中间状态。
