vagrant中go命令报错因path未生效，需apt安装golang-go并写入/etc/profile.d/go.sh；私有仓库需ssh-add vagrant密钥；rsync同步规避inotify问题；-race挂起需绑定tsc或限gomaxprocs。
为什么 vagrant up 启动后 go version 报错“command not found”
默认 Vagrant box（比如 ubuntu/focal64）不预装 Go，即使你写了 config.vm.provision，也常因执行时机或 shell 环境隔离导致 PATH 未生效。常见现象是：手动登录后能运行 go，但 vagrant ssh -c "go version" 就失败。
- 用
apt安装时优先选golang-go（Ubuntu/Debian），不是golang（那是旧包名，可能装错版本） - 避免用
curl | bash方式安装，Vagrant provision 默认用非交互式 shell，~/.bashrc不加载，GOROOT/PATH不会自动设好 - 在 provision 脚本末尾显式写入：
echo 'export PATH=$PATH:/usr/lib/go/bin' >> /etc/profile.d/go.sh，并确保该文件被所有 shell 读取
如何让 go mod 在虚拟机里正确拉取私有 Git 仓库
宿主机 SSH agent 不自动透传进 Vagrant 虚拟机，git@github.com:org/repo.git 类地址会因权限拒绝失败，报错类似：fatal: Could not read from remote repository. Please make sure you have the correct access rights.
- 不要在 Vagrantfile 中用
config.ssh.forward_agent = true依赖宿主机密钥——这要求宿主机始终在线且 agent 活跃，CI 或协作场景下不可靠 - 改用
ssh-add ~/.vagrant.d/insecure_private_key在 provision 阶段把 Vagrant 自带密钥加进 agent，再配 Git URL 为ssh://git@github.com/org/repo.git（注意协议前缀） - 若用自建 Git 服务，需在
/etc/hosts或~/.ssh/config中显式指定HostName和IdentityFile，否则go mod的 SSH 调用不读~/.ssh/config
Vagrantfile 里该用 synced_folder 还是 rsync 模式同步 Go 项目
Go 编译器对文件系统事件敏感（如 go run 监听源码变化），VirtualBox Guest Additions 在某些内核版本下触发 inotify 事件不稳定，表现为 air 或 reflex 热重载失效。
- 禁用默认的
virtualbox共享文件夹（即不设type: "virtualbox"），改用type: "rsync"——它把代码单向复制进 VM，规避 inotify 问题，适合开发编译流程 - 启用
rsync__auto: true后，每次vagrant reload或vagrant provision会自动同步，但保存代码后需手动vagrant rsync才能更新，别误以为“实时” - 如果必须双向实时同步（比如调试需要修改 VM 内生成的临时文件），保留
virtualbox类型，但要在/etc/default/virtualbox-guest-utils中确认LOAD_VBOXSF=1，并重启vboxadd-service
VirtualBox + Vagrant 下 go test -race 偶发挂起或超时
Go 的 race detector 依赖高精度时间戳和内存屏障，在 VirtualBox 的默认 CPU 虚拟化配置下，TSC（时间戳计数器）不稳定，导致 -race 检测线程死锁判断失准，尤其在多核启用但未开启嵌套分页时。
- 在
Vagrantfile的vb.customize块中加入：["setextradata", :id, "VBoxInternal/TM/TSCTiedToExecution", "1"]，强制 TSC 与指令执行绑定 - 关闭 VirtualBox 的“启用硬件虚拟化（VT-x/AMD-V）”选项反而可能更稳——某些宿主机 BIOS 开启 VT-x 后，Guest OS 对 TSC 的模拟反而更差
- 测试时加
GOMAXPROCS=2限制线程数，减少 race detector 调度压力，比盲目增加 timeout 更有效
