XLT Project Switcher (项目切换助手)
XLT Project Switcher 是一个极简、高效的 VS Code 项目管理插件。它提供了一个常驻侧边栏的看板,帮助您快速在最近使用的项目之间切换,同时集成了项目创建、克隆和搜索功能。
✨ 核心特性 (Features)
- 🗂️ 自动记录与管理: 自动记录您打开过的项目历史,无需手动添加。
- 多根工作区: 同时打开多个文件夹或被
.code-workspace 打开时,所有文件夹都会记录。
- 🎨 智能可视化:
- 根据项目名称自动生成 马卡龙色系 的精致图标。
- 支持中文首字和英文缩写生成。
- 失效检测: 自动检测并置灰显示已删除或移动的项目路径。
- 可定制外观: 右键项目即可自定义背景色、Emoji 或本地图片作为图标。
- 📌 组织与排序:
- 置顶: 常用项目一键置顶,始终排在最前。
- 别名: 为路径冗长的项目设置更易识别的显示名称。
- 标签: 用逗号分隔的标签归类项目(如
工作, 学习),搜索时同样命中。
- 排序模式: 手动拖拽 / 按最近使用 / 按名称排序。
- ⚡ 极速工作流:
- 新建项目: 内置生成器,支持创建 Vue / React / Nuxt / Vite 或空白项目。
- 克隆仓库: 一键调用 Git Clone,无需记忆复杂命令。
- 本地打开: 快速浏览并打开本地文件夹。
- 项目快捷操作: 在终端中打开、在文件管理器中显示、复制路径、运行
package.json 脚本。
- 扫描目录: 选中一个大目录,自动发现其中的项目并批量加入列表。
- 列表管理: 支持从历史中移除项目、一键清理全部失效路径,均支持「撤销」。
- 导入 / 导出: 将项目列表导出为 JSON 备份,或在新机器上一键导入。
- 统计: 记录每个项目的打开次数,最近使用一目了然;内置统计面板展示总数 / 失效 / Top5。
- 返回上一个项目: 一键回到切换前的项目。
- 🔍 实时搜索: 毫秒级过滤,支持按项目名、别名、标签或路径模糊搜索,命中词会高亮,并支持键盘上下选择。
- ⌨️ 快捷键支持: 全局快捷键 + 侧边栏内
Ctrl/Cmd+F 搜索、↑/↓ 选择、Enter 打开、Ctrl/Cmd+Enter 新窗口打开。
- 🌐 中英双语: 命令、设置与侧边栏文案随 VS Code 显示语言自动切换。
🚀 使用指南 (Usage)
侧边栏面板
安装插件后,您会在 VS Code 左侧活动栏看到一个新的图标(文件夹样式)。点击即可打开“项目列表”面板。
- 单击卡片: 按配置的
projectSwitcher.openMode 打开项目(当前窗口 / 新窗口 / 每次询问)。
- Ctrl/Cmd + 单击卡片: 始终在新窗口打开。
- 右键卡片: 当前窗口打开 / 新窗口打开 / 置顶 / 重命名别名 / 设置标签 / 在终端中打开 / 运行脚本 / 在文件管理器中显示 / 复制路径 / 编辑外观 / 从列表移除。
- 分组展示: 「当前打开」「置顶」「最近项目」三个分组,置顶项目始终在最前。
- 拖拽排序: 在
manual 排序模式下拖拽卡片即可调整顺序。
- 最近使用: 卡片上以相对时间展示上次打开时间(可在设置中关闭)。
- 新建项目: 点击顶部的“新建项目”按钮,选择模板(如 Vue/React)并输入名称,插件会自动创建并打开终端辅助您完成初始化。
- 克隆仓库: 点击“克隆仓库”按钮,粘贴 Git URL 即可开始克隆。
- 清理失效项目: 当存在已删除/移动的项目时,面板会出现「清理失效项目 (N)」按钮,一键移除全部失效记录(可撤销)。
- 扫描 / 统计: 底部「扫描」可选择目录并批量加入项目;「统计」展示项目总量与最常打开的项目。
- 底部操作: 扫描 / 统计 / 导出 / 导入 / 清空历史 / 打开扩展设置。
快捷键 (Shortcuts)
| 功能 |
macOS |
Windows / Linux |
| 切换项目(QuickPick) |
Cmd+Alt+P |
Ctrl+Alt+P |
| 切换项目(新窗口) |
Cmd+Alt+Shift+P |
Ctrl+Alt+Shift+P |
| 返回上一个项目 |
Cmd+Alt+B |
Ctrl+Alt+B |
| 打开项目列表侧边栏 |
Cmd+Alt+S |
Ctrl+Alt+S |
| 新建项目 |
Cmd+Alt+N |
Ctrl+Alt+N |
| 打开本地项目 |
Cmd+Alt+O |
Ctrl+Alt+O |
| 克隆仓库 |
Cmd+Alt+G |
Ctrl+Alt+G |
侧边栏获得焦点时,还支持:
| 按键 |
功能 |
Ctrl/Cmd + F |
聚焦搜索框 |
↑ / ↓ |
在项目卡片间移动选择 |
Enter |
打开选中项目 |
Ctrl/Cmd + Enter |
在新窗口打开选中项目 |
Delete / Backspace |
从列表移除选中项目(可撤销) |
Esc |
清空搜索并取消选择 |
快捷命令
按 Cmd+Shift+P (Mac) or Ctrl+Shift+P (Win) 打开命令面板,输入:
项目切换助手: 切换项目 (projectSwitcher.switch): 快速弹出一个下拉列表来搜索和切换项目(无需打开侧边栏)。列表项右侧提供「置顶」和「新窗口打开」按钮。
项目切换助手: 切换项目(在新窗口打开) (projectSwitcher.switchNewWindow): 同上,但直接在新窗口打开。
项目切换助手: 返回上一个项目 (projectSwitcher.switchPrevious): 回到最近一次切换前的项目。
项目切换助手: 新建项目 (projectSwitcher.createProject): 直接进入新建项目流程。
项目切换助手: 打开本地项目 (projectSwitcher.openFolder): 选择本地文件夹或 .code-workspace 并打开。
项目切换助手: 克隆仓库 (projectSwitcher.cloneRepo): 调用 Git Clone。
项目切换助手: 打开项目列表 (projectSwitcher.showSidebar): 打开侧边栏面板。
项目切换助手: 刷新项目列表 (projectSwitcher.refresh): 重新检测路径有效性并重绘。
项目切换助手: 扫描目录添加项目 (projectSwitcher.scanProjects): 发现目录下的项目并批量加入。
项目切换助手: 查看项目统计 (projectSwitcher.showStats): 查看总数、失效数与最常打开的项目。
项目切换助手: 导出项目列表 (projectSwitcher.exportList): 导出为 JSON 文件。
项目切换助手: 导入项目列表 (projectSwitcher.importList): 从 JSON 文件合并导入。
项目切换助手: 清空项目历史 (projectSwitcher.clearHistory): 清空全部记录(需确认)。
项目切换助手: 打开设置 (projectSwitcher.openSettings): 打开本扩展的设置页。
配置项 (Settings)
| 配置 |
类型 |
默认值 |
说明 |
projectSwitcher.openMode |
current / new / ask |
current |
打开项目的方式:当前窗口、新窗口或每次询问 |
projectSwitcher.sortMode |
manual / recent / name |
manual |
列表排序方式,置顶项目始终排在最前 |
projectSwitcher.colorPalette |
vibrant / pastel / dark / macaroon |
vibrant |
自动生成图标的配色方案 |
projectSwitcher.maxHistory |
number (10-200) |
50 |
最多保存的项目数量 |
projectSwitcher.showStatusBar |
boolean |
true |
是否在状态栏显示当前项目入口 |
projectSwitcher.confirmBeforeRemove |
boolean |
true |
移除 / 清理项目前是否二次确认 |
projectSwitcher.showRelativeTime |
boolean |
true |
卡片是否显示最近使用时间 |
projectSwitcher.autoPruneMissing |
boolean |
false |
启动时自动清理失效项目 |
📦 安装 (Installation)
- 在 VS Code 扩展商店搜索
xlt-project-switcher(完整 ID:xlt-icon.xlt-project-switcher)。
- 点击安装。
🛠️ 开发与贡献 (Development)
本项目使用 TypeScript 开发。
# 克隆项目
git clone https://github.com/xiaoLangtou/vscode-project-switcher.git
# 安装依赖
npm install
# 启动调试 (F5)
npm run watch
# 代码检查 / 单元测试
npm run lint
npm test
# 打包 VSIX
npx @vscode/vsce package
CI(.github/workflows/ci.yml)会在每次推送时执行 lint → 编译 → 测试 → 打包。
📄 License
MIT
| |