KVM虚拟机分辨率需通过SPICE协议、virtio-gpu/qxl驱动及spice-vdagent协同配置：先启用SPICE显示，再确认virtio-gpu驱动加载，最后安装spice-vdagent（Linux）或SPICE Guest Tools（Windows），并重启生效。
KVM虚拟机安装后分辨率怎么调？
刚装完KVM虚拟机，桌面默认卡在640×480或800×600，文字糊成一片、窗口拖不动、连终端都看不清——这不是系统坏了，而是虚拟显卡驱动和显示协议还没真正就位。你得先让Guest OS“看见”那块虚拟GPU，再让它“听懂”SPICE传来的画面指令。
第一步：确认虚拟机已启用SPICE显示协议。用virsh edit修改XML配置，在<graphics></graphics>节点下确保type为spice，且<listen type="address"></listen>已设置；若用virt-manager创建，新建时“图形显示”类型必须选SPICE而非VNC。
第二步：检查Guest内核是否加载了virtio-gpu驱动。启动虚拟机后执行dmesg | grep -i virtio_gpu，出现virtio_gpu: initialized才说明驱动已就绪；若无输出，说明当前video设备未匹配到正确驱动，需回退修改XML中的<video></video>模型。
第三步：在Guest中手动触发分辨率自适应。Windows虚拟机运行spice-webdavd服务并打开SPICE客户端的“缩放”菜单→勾选“自动调整窗口大小”；Linux虚拟机（如Ubuntu）执行xrandr --auto，若报错“No outputs have a mode”，说明SPICE QXL驱动未加载，需进入下一步。
Spice驱动与显卡配置安装方法
SPICE不是插件，是整套图形栈——它由宿主机QEMU的SPICE server、Guest内核的virtio-gpu或qxl驱动、以及用户态的spice-vdagent三者咬合运转。缺任何一环，分辨率就锁死在基础模式。
方法一：Linux Guest自动安装spice-vdagent（推荐）
本地 Ollama 文生图工具。使用 x/z-image-turbo 模型生成图片，分辨率 1024x1024，每张图约耗时 90 秒。当用户说"生成图片"、"文生图"、"画一张图"、或提交中文提示词生成图像时使用。
Debian/Ubuntu系直接运行：sudo apt install spice-vdagent → 安装完成后sudo systemctl enable --now spice-vdagentd → 重启虚拟机。这一步会自动注册X11输入设备、同步剪贴板，并让xrandr识别SPICE输出端口。
方法二：Windows Guest手动安装SPICE Guest Tools
从https://www.spice-space.org/download.html 下载最新版spice-guest-tools-*.exe，在虚拟机内以管理员身份运行→全程点“下一步”即可；安装器会静默部署qxl显卡驱动、spice-webdavd服务和vdagent。安装后务必重启，否则设备管理器里仍显示“Microsoft Basic Display Adapter”。【不重启=白装】
方法三：强制指定virtio-gpu设备（解决银河麒麟等国产OS黑屏问题）
编辑virsh XML：<video><model type="virtio" heads="1" ram="262144" vram="262144"></model></video> → 删除原有qxl或vga设备 → 保存退出 → 启动虚拟机。此配置绕过QXL驱动兼容性陷阱，强制使用更稳定的virtio-gpu DRM/KMS路径，特别适配Linux 5.4+内核的银河麒麟V10、统信UOS等系统。
最后验证：Linux Guest中执行xrandr -q | grep connected，应返回类似spice-0 connected primary 1920x1080+0+0 (normal left inverted right x axis y axis) 477mm x 268mm；Windows Guest右键桌面→显示设置→分辨率下拉列表中必须出现1920×1080及以上选项，且能实时生效。
