Local History插件无默认快捷键，需手动绑定Ctrl+Alt+L至extension.localHistory.showFileHistory命令；避免与默认键位冲突，配合.gitignore添加“.history/”可忽略该文件夹而不影响功能。
Local History插件配套的快捷键怎么设才不冲突
Local History插件本身不绑定任何默认快捷键，所有历史版本操作都得靠右键菜单或命令面板触发——这意味着你必须手动打开“Local History”侧边栏、选文件、点快照，效率很低。真正提升体验的关键，是给核心命令手动绑定快捷键。
容易踩的坑是直接套用其他插件或旧教程里的键位，比如 Ctrl+Alt+H，它在 VSCode 默认被 workbench.action.toggleSidebar 占用；又或者用 Ctrl+Shift+H，这和“全局搜索”冲突。结果就是按了没反应，还以为插件坏了。
- 推荐绑定到
Ctrl+Alt+L（L 代表 Local）：目前 VSCode 官方默认未占用，且和插件名首字母一致，好记 - 绑定命令为
extension.localHistory.showFileHistory（注意不是showHistory，后者无效） - 如果已装有 Vim 插件，务必检查
vim.mode是否启用——它会拦截Ctrl+Alt+L，临时禁用或加when条件如"!vim.mode"
回退编辑位置 vs 回退文件内容：别混用 Alt+← 和 Local History
很多人以为 Alt+←（Windows/Linux）或 Cmd+Alt+←（macOS）能“撤销文件修改”，其实它只跳转光标位置（Go Back），和 Local History 记录的文件快照完全无关。你用它来回跳，只是在函数定义、引用、搜索结果之间穿梭，不会还原哪怕一行代码。
真正还原内容的操作只有两个：一是右键文件 → “Show Local History”，二是执行你刚配好的快捷键打开历史列表，再双击某个时间点的快照。
-
Alt+←/Alt+→管导航历史，Ctrl+Z管编辑撤销栈，Local History管保存级快照——三者互不覆盖，也不共享状态 - 如果刚保存后立刻想退回上一版，
Ctrl+Z还有效；但关过文件再开，就只能靠 Local History - 误删整段代码后，别浪费时间狂按
Ctrl+Z，直接调extension.localHistory.showFileHistory找 2 分钟前的快照更稳
命令面板里快速唤出 Local History 命令的技巧
即使没设快捷键，也能在命令面板高效使用 Local History：按 Ctrl+Shift+P 后，**不输入任何字，直接按 ↑ 键**，就能拉出最近用过的命令。只要之前手动点过一次“Show Local History”，它就会出现在顶部。
但这个机制有硬限制：只保留约 20 条，且重启 VSCode 就清空。所以第一次配置完，务必手动执行一次命令，把它“钉”进历史列表。
- 搜命令时输
local比history更准，因为插件注册的命令名都含localHistory - 避免输全称
extension.localHistory.showFileHistory——太长易错，VSCode 模糊匹配足够识别local file - 如果按 ↑ 没反应，先确认焦点是否在命令面板输入框内；Mac 用户还要检查触控板手势是否劫持了 ↑ 方向键
配合 .gitignore 隐藏 .history 文件夹但不影响功能
Local History 生成的 .history 文件夹默认在项目根目录，Git 会把它当普通文件夹跟踪。虽然插件自己不读 Git，但你 git status 时总看到一堆未跟踪文件，很干扰。
正确做法不是删掉 .history，而是让 Git 忽略它——但要注意 .gitignore 的写法细节，否则插件可能报错或停止记录。
- 在项目根目录
.gitignore中添加一行：.history/（结尾斜杠不能少，否则只忽略同名文件，不忽略文件夹） - 不要写成
**/.history或.history（无斜杠），前者可能误忽略其他路径下的同名文件，后者在某些 Git 版本下不生效 - 加完后执行
git rm -r --cached .history清除 Git 缓存，否则已有跟踪记录仍会显示 - 插件完全不受影响——它只管往磁盘写，不管 Git 是否跟踪
