必须依赖vagrant自动化管理虚拟机生命周期，避免手动配置引发的“在我机器上能跑”问题；需先确认uname -m输出为x86_64，再依次安装virtualbox、vagrant，修改vagrantfile指定generic/debian12镜像、禁用vbguest自动更新、限制内存与cpu，最后vagrant up启动并验证。
在统信UOS上快速搭建可复现、跨团队一致的开发环境，必须依赖Vagrant自动化管理虚拟机生命周期，避免手动配置引发的“在我机器上能跑”问题。
安装Vagrant和VirtualBox
统信UOS桌面版默认不预装Vagrant或VirtualBox，需手动安装。先确认系统架构：【必须运行 uname -m，输出为 x86_64 才能继续】，ARM版暂不支持VirtualBox后端。
打开终端，依次执行：
sudo apt update → sudo apt install virtualbox-qt virtualbox-dkms
安装VirtualBox时会自动编译内核模块，若提示“modprobe vboxdrv failed”，说明当前内核未签名或Secure Boot开启——【此时需重启进BIOS关闭Secure Boot，否则Vagrant无法启动任何box】。
接着安装Vagrant：访问 https://releases.hashicorp.com/vagrant/ ，下载最新amd64 .deb包（如 vagrant_2.4.10_x86_64.deb），然后运行 sudo dpkg -i vagrant_*.deb；若提示依赖错误，补上 sudo apt --fix-broken install。
初始化并配置Vagrantfile
新建项目目录，例如 ~/myproject，进入后执行 vagrant init。
这会生成默认Vagrantfile，但统信UOS下需立即修改三处关键项：
① 将 config.vm.box = "base" 改为 config.vm.box = "generic/debian12"
② 在 config.vm.network 部分下方新增一行：config.vbguest.auto_update = false ——因为VirtualBox Guest Additions在UOS上与Debian box存在版本冲突，自动更新会导致挂载失败。
③ 在 provider "virtualbox" 块内添加内存和CPU限制：vb.memory = "2048" 和 vb.cpus = "2"，避免虚拟机吃光宿主机资源卡死桌面。
启动并验证虚拟机
方法一：直接运行 vagrant up，Vagrant会自动下载generic/debian12 box（约500MB），解压并启动。
方法二：若公司内网无外网权限，提前在有网机器下载box文件（https://vagrantcloud.com/generic/boxes/debian12），用 vagrant box add generic/debian12 /path/to/file.box 导入，再执行 vagrant up。
启动成功后，运行 vagrant ssh 测试连通性；退出后执行 vagrant halt 关机，vagrant status 应显示“poweroff”。
注意：首次 vagrant up 后不要立刻 vagrant destroy，因为box已缓存，下次创建同版本虚拟机将跳过下载，速度提升3倍以上。
