English | 中文

适用于 Windows 10/11 的虚拟桌面快速切换工具，通过 Alt + 1~9 直达指定桌面，并配有可自定义的桌面状态指示器。

• 快捷键切换：Alt + 1 ~ Alt + 9 快速跳转到对应虚拟桌面（按键和修饰键均可自定义）
• 返回上一桌面：Alt + ` 切换到上一个所在的虚拟桌面
• 窗口固定到所有桌面：Alt + D 将当前窗口固定到所有虚拟桌面（或取消固定），切换桌面时窗口保持可见。
• 桌面指示器：使用不同的符号表示不同的虚拟桌面，可表示 ◉ 当前虚拟桌面、○ 非空桌面和 ◌ 空桌面，支持自定义位置、大小和样式
• 滚轮切换：鼠标悬停在指示器上滚动滚轮可快速切换上一个/下一个虚拟桌面
• 拖动窗口到指示器：将任意窗口拖到指示器符号上即可将该窗口移动到对应虚拟桌面，并自动切换到该虚拟桌面。
• 极其轻量：可执行文件 ~140KB，内存占用 ~2MB，零依赖、静默运行。

• Github Release 从 Releases 页面下载最新的 VirtualDesktopSwitcher.exe，放在任何位置，双击运行即可。
• 使用winget安装

  winget install Chooyy.VirtualDesktopSwitcher

如需从源码编译，请参考下方 编译 部分。

• 启动 VirtualDesktopSwitcher.exe
• 屏幕显示桌面状态指示器，系统托盘出现程序图标
• 使用 Alt + 1 ~ Alt + 9 切换虚拟桌面
• 使用 Alt + ` 返回上一个虚拟桌面
• 使用 Alt + D 将当前窗口固定到所有桌面（或取消固定）
• 鼠标悬停在指示器上滚动滚轮切换上一个/下一个虚拟桌面
• 拖拽窗口到指示器符号上，将窗口移动到对应桌面并自动切换过去
• 右键托盘图标进行设置：
  • 调整指示器位置、大小、样式、快捷键、显示
  • 管理开机自启、管理员启动

1. 双击托盘图标快速切换指示器显示/隐藏

配置文件保存至 %LOCALAPPDATA%\VirtualDesktopSwitcher\config.ini，在配置文件中可自定义切换、固定虚拟桌面的键为其他按键。

虚拟键码可参考 Virtual-Key Codes。例如数字键盘 1~9 对应 97~105。

如果需要自定义切换虚拟桌面的键，可按照上述表格说明修改配置文件，例如使用 Alt + qweasdzxc 切换桌面 1~9：

[General]
DesktopKey1=81    ; Q
DesktopKey2=87    ; W
DesktopKey3=69    ; E
DesktopKey4=65    ; A
DesktopKey5=83    ; S
DesktopKey6=68    ; D
DesktopKey7=90    ; Z
DesktopKey8=88    ; X
DesktopKey9=67    ; C

• MSVC C++ 工具链（需支持C++20）
• xmake 构建工具

# 直接编译
xmake

# 生成 Visual Studio 工程文件（可选）
xmake project -k vsxmake

编译产物位于 build 目录。

部分应用（如任务管理器）的键盘快捷键在普通权限下无效，需要以管理员身份运行程序。

• 以管理员启动：右键托盘图标 → 以管理员启动。该设置持久化保存，下次启动时自动提权（弹 UAC 确认框）。
• 开机自启（普通权限）：写入注册表 HKCU\Software\Microsoft\Windows\CurrentVersion\Run。
• 开机自启（管理员权限）：以管理员身份勾选开机自启时，自动使用任务计划程序创建登录时启动任务（/rl highest），启动过程无 UAC 弹窗。
• 启动项清理：托盘图标右键点击退出时会自动删除注册表键和计划任务，此时可直接删除程序不留残留。

本项目的桌面指示器部分移植自 vladelaina 的开源项目 Catime，感谢原作者的优秀作品!