Auto Stash Switch Branch
一个 VSCode 插件，提供类似 JetBrains IDE 的自动暂存切换分支体验。
功能特性
- 🔄 自动检测未提交修改：切换分支前自动检测工作区是否有未提交的修改
- 📦 智能暂存：自动暂存未提交修改，避免丢失工作进度
- 🔍 分支选择：提供友好的分支选择界面，支持搜索
- 🔄 自动恢复：切换回原分支时自动检测并恢复暂存的修改
- ⚡ 快捷键支持：
Ctrl+Shift+G (Windows/Linux) 或 Cmd+Shift+G (macOS)
- 📝 变更内容预览：暂存/恢复前弹窗预览 diff 前10行，并可一键点开查看全部 diff 内容
使用方法
1. 通过命令面板
- 按
Ctrl+Shift+P (Windows/Linux) 或 Cmd+Shift+P (macOS) 打开命令面板
- 输入 "Auto Stash and Switch Branch"
- 选择该命令
2. 通过快捷键
- 直接按
Ctrl+Shift+G (Windows/Linux) 或 Cmd+Shift+G (macOS)
工作流程
- 检测未提交修改：插件会检查当前工作区是否有未提交的修改
- 用户确认暂存：如果有未提交修改，会弹窗预览 diff 前10行，并可点开查看全部内容，选择是否暂存
- 选择目标分支：显示可用的分支列表供用户选择
- 自动切换分支：执行分支切换操作
- 恢复暂存：如果目标分支有之前暂存的修改，会弹窗预览 stash diff 前10行，并可点开查看全部内容，选择是否恢复
安装
从源码安装
- 克隆此仓库
- 运行
npm install 安装依赖
- 运行
npm run compile 编译代码
- 在 VSCode 中按
F5 启动调试模式
从 VSIX 安装
- 下载
.vsix 文件
- 在 VSCode 中按
Ctrl+Shift+P 打开命令面板
- 输入 "Extensions: Install from VSIX"
- 选择下载的
.vsix 文件
开发
环境要求
开发命令
# 安装依赖
npm install
# 编译代码
npm run compile
# 监听文件变化并自动编译
npm run watch
# 运行测试
npm test
# 代码检查
npm run lint
配置
插件使用 VSCode 的全局存储来保存分支与暂存信息的映射关系。暂存信息会在24小时后自动清理。
注意事项
- 插件仅在 Git 仓库中工作
- 所有自动操作都需要用户确认，确保安全
- 如果遇到复杂的合并冲突，需要用户手动解决
- 暂存信息会在24小时后自动清理
- 自动暂存仅支持通过插件命令/快捷键切换分支，分支切换后自动弹窗恢复
故障排除
常见问题
插件无法激活
- 确保当前工作区是 Git 仓库
- 检查 VSCode 版本是否支持
Git 命令执行失败
- 确保系统已安装 Git
- 检查 Git 配置是否正确
暂存恢复失败
- 检查是否有冲突
- 手动执行
git stash pop 查看详细错误信息
贡献
欢迎提交 Issue 和 Pull Request！
许可证
MIT License
| |
