Skip to content
| Marketplace
Sign in
Visual Studio Code>Other>XLT Project SwitcherNew to Visual Studio Code? Get it now.
XLT Project Switcher

XLT Project Switcher

xlt-icon

|
1 install
| (0) | Free
Quickly switch between projects with auto-generated colorful icons.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

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)

  1. 在 VS Code 扩展商店搜索 xlt-project-switcher(完整 ID:xlt-icon.xlt-project-switcher)。
  2. 点击安装。

🛠️ 开发与贡献 (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

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft