先贴地址和安装...目前暂时只支持了 Homebrew 。手动安装可以自行编译或走 GitHub Release 。
开源地址： /ai-market-guide/ Homebrew 安装： brew install --cask normal-coder/tap/vmctl 为什么写这个 核心还是解决自己的使用问题（笑。出于对环境纯粹的洁癖，一般各种新工具的尝试还是选择在干净的 OS 内去解决。
考虑到各种安全、隔离问题，有些环境不想/不适用用容器。于是常年在重装各种系统和各种初始化中来来去去，每次操作都相当耗费心神。
初始化系统的活儿交给 Agent 干，心里又不踏实😩。 。
于是反复在各种老牌虚拟化方案和新晋虚拟机中来回捯饬。最终。
。对个人免费的 VMware 还是真香 😂😂😂 VMware 漫长的历史和博通的产品调性。
让 VMware 比起 PD/OrbStack/Lima 一众产品，开发者友好程度不太够。 vmrun 的参数太反人类了——快照、克隆、往 guest 里拷个文件，每样都要记一长串路径参数，用完就忘；敲起來还费手 用惯了 Parallels 的 prlctl ，换到 VMware 之后发现没有对应手感的 CLI 想脚本化批量操作，GUI 点不动；管 vSphere 又不想开浏览器 ... 为了手感 。
照着 prlctl 的命令风格写了一个，底层用统一的 Driver 接口把两种后端收进同一套命令里。快速感受 $ vmctl list ┌────────────┬───────┬─────┬─────────┬─────────────┬──────────────────────────────────────┐ │ 名称 │ 状态 │ CPU │ 内存 │ 客户机系统 │ UUID │ ├────────────┼───────┼─────┼─────────┼─────────────┼──────────────────────────────────────┤ │ ubuntu-dev │ on │ 4 │ 8192 MB │ Ubuntu 24.04│ 564d1156-abcd-ef01-2345-678901234567 │ │ win11 │ off │ 8 │ 16384 MB│ Windows 11 │ 564d9876-2345-6789-abcd-ef0123456789 │ └────────────┴───────┴─────┴─────────┴─────────────┴──────────────────────────────────────┘ 📊 基础信息 功能 / 命令语法 备注 列出所有虚拟机 vmctl list 支持 --json 输出格式。
查看虚拟机详情 vmctl info 显示名称、UUID 、Tools 状态、Guest IP 等。查看版本信息 vmctl version 支持 --json 输出格式。
🔌 电源管理 功能 / 命令语法 备注 启动虚拟机 vmctl start [--nogui] 返回即代表已加电，不等待 Guest OS 就绪。关闭虚拟机 vmctl stop [--hard] --hard 表示强制断电。
挂起虚拟机 vmctl suspend 暂停并保存当前状态到磁盘。恢复虚拟机 vmctl resume 恢复被挂起的虚拟机。
暂停虚拟机 vmctl pause 暂停虚拟机运行（保持在内存中）。重启虚拟机 vmctl reset [--hard] --hard 表示强制重启。
🔄 生命周期 功能 / 命令语法 备注 克隆虚拟机 vmctl clone --name [--full] [--snapshot ] [--path ] 默认链接克隆；--full 为完整拷贝。 vmrun 后端要求源 VM 已关机，vSphere 支持开机克隆。
派生新虚拟机 vmctl create --from [--memory 4096] [--cpus 4] [--full] 从现有 VM 派生（ vmrun 后端不支持从零创建裸 VM ）。修改虚拟机配置 vmctl set --memory 4096 --cpus 4 [--name ] 必须在虚拟机已关机状态下执行。
删除虚拟机 vmctl delete 删除虚拟机及其全部文件，不可恢复。 📸 快照管理 功能 / 命令语法 备注 列出快照 vmctl snapshot list [--tree] --tree 可按树状结构展示快照关系。
创建快照 vmctl snapshot create 为当前状态创建快照。删除快照 vmctl snapshot delete [--children] --children 表示连同子快照一并删除。
恢复快照 vmctl snapshot revert 必须在虚拟机已关机状态下执行。会一并恢复快照时的电源状态。
🖥️ Guest OS 交互 功能 / 命令语法 备注 执行 Guest 命令 vmctl exec [-u root] -- ' ' 经 /bin/sh 执行，捕获输出并透传退出码。要求 VM 已开机且安装 VMware Tools 。
查看 Guest IP vmctl ip [--wait] 脚本友好，直接输出裸 IP 。要求安装 VMware Tools 。
SSH 进入 Guest vmctl shell [--user u] [--port 22] [-i key] [--wait] [--dry-run] 要求 Guest 开启 sshd 。 -- 之后的参数会透传给 ssh 命令（如 vmctl shell -- -v ）。
特性 双后端一套命令 ：默认 vmrun （本机 Fusion / Workstation ）， --backend vsphere 直连 vCenter / ESXi （ govmomi ），本地和实验室环境切换只是换一个参数； VM 引用很随意 ：显示名、名称的唯一子串、UUID 前缀、 .vmx 路径、vSphere 的 MoRef （ vm-42 ）都能用，不必先查 UUID ； 同名快照消歧 ：vmrun 按名字操作快照，撞名时给出 名字#uid 候选引用（走 Fusion 13.5+ 的 vmcli ）： guest 内执行 ： vmctl exec -- 'df -h' 捕获输出并透传退出码， vmctl shell 直接 SSH 进去（ -- 之后透传给 ssh ）； 为脚本设计 ： --json 全命令覆盖；退出码分级（ 0 成功 / 1 运行错误 / 2 用法错误 / 3 对象不存在 / 4 后端不支持，exec 再透传 guest 程序退出码）； 中文界面 ：帮助和报错默认中文， --lang en 切英文； shell 补全内置，VM 名是动态读当前后端列表补的； 多 profile 配置 ： ~/.config/vmctl/config.yaml 里配好本地 + 远程两套环境， --profile lab 一条命令切换。
技术栈与现状 Go + cobra + govmomi + go-pretty ，单二进制无运行时依赖，MIT 协议。当前 0.x 阶段，还有一些问题尚未解决。
但做好一个基础镜像后，后续的工作就好弄了。 。
。 vmrun 后端不支持从零创建裸虚拟机（ create 需要 --from 一个现有 VM ）； vSphere 后端部分电源操作（如 pause ）按设计返回「不支持」退出码 4 ，还在真机验证中； exec / shell / ip 依赖 guest 内装有 VMware Tools （或开了 sshd ）。
最后 写这个主要自用，但如果你也在 macOS 上折腾 VMware 、或者受够了 vmrun 的参数，欢迎来提 issue / PR ，特别是 vSphere 场景的真机反馈： /ai-market-guide/ Happy Hacking 🙌