git-time-machine 插件需通过apm安装、依赖Git环境且仅对Git仓库根目录下已跟踪文件生效，支持快捷键Ctrl+Shift+T唤出时间轴并实时对比历史提交。
git-time-machine插件能直接在 Atom 编辑器里打开时间轴视图，点选任意提交就能对比文件差异——不需要切到终端或浏览器，也不依赖 GitHub Desktop。
安装命令必须用 apm，不能用 npm 或 GUI 点击安装
Atom 的插件生态只认 apm（Atom Package Manager），不是 npm。如果你在终端里执行 npm install git-time-machine，插件不会出现在 Atom 中，也不会被加载。
- 确保已安装 Git：运行
git --version有输出，否则插件启动时会报错Git not found - 在终端中执行：
apm install git-time-machine（注意是apm，不是atom或npm） - 安装完成后重启 Atom —— 即使插件列表显示“已启用”，不重启也可能无法响应右键菜单
右键菜单失效？检查当前文件是否在 Git 仓库根目录下
git-time-machine 只对「已被 Git 跟踪」且「位于工作区根目录内」的文件生效。如果文件路径是 /home/user/project/src/index.js，但你是在 /home/user/project/src/ 目录下用 Atom 打开的，插件可能识别不到仓库根，导致右键无 Time Machine 选项。
- 正确做法：用 Atom 打开整个项目根目录（即含
.git文件夹的目录） - 验证方式：按
Ctrl+Shift+H能唤出 Atom 自带 Git 面板，说明仓库识别正常 - 如果仍不出现菜单，尝试在编辑器中右键 →
Git: Toggle Git Tab，先激活内置 Git 支持
时间轴空白或加载失败？常见原因只有两个
点击右键 → Git Time Machine 后弹出空面板、卡在 loading 或提示 No commits found，基本就这两类问题：
- 当前分支没有提交记录：新建仓库但还没
git commit，或者当前文件是新添加未git add的 - Git 配置缺失用户信息：运行
git config --global user.name和git config --global user.email，若为空，某些 Git 版本会拒绝生成提交历史供插件读取
快捷键和触发方式比菜单更可靠
右键菜单有时受主题或其它插件干扰，而快捷键是插件原生绑定的，稳定性更高。
- 聚焦在编辑器中任意位置，按
Ctrl+Shift+T（Windows/Linux）或Cmd+Shift+T（macOS）直接唤出时间轴 - 该快捷键只对当前打开的、已被 Git 跟踪的文件生效；切换标签页后需重新触发
- 时间轴顶部显示当前分支名，点击分支名可切换，但切换后需手动刷新（关闭再重开面板）
插件本身不缓存历史，每次打开都实时调用 git log 和 git show，所以大仓库首次加载稍慢是正常的——这不是 bug，也无需额外配置。真正容易被忽略的是：它不支持子模块内文件的时间旅行，哪怕子模块已初始化，git-time-machine 也只查主仓库的提交记录。
