deployment → mappings 中 local path 和 deployment path 必须完全一致（含大小写、空格、结尾斜杠），否则导致断点失效、编译报错“cannot find module”、文件上传后找不到；需用虚拟机中 pwd 获取绝对路径，严格匹配。
Deployment → Mappings 里 Local path 和 Deployment path 必须完全一致
断点灰、编译报 cannot find module providing package、上传后文件找不到——八成是这里错了。GoLand 不会自动补全或归一化路径，/home/vagrant/myapp 和 /home/vagrant/myapp/（结尾多一个 /）在 SFTP 映射里就是两个不同路径；~/myapp 在本地可能展开为 /Users/me/myapp，但虚拟机里根本没 ~ 这个概念。
实操建议：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 进虚拟机，cd 到项目根目录，执行
pwd，复制完整绝对路径（比如/home/vagrant/myapp），粘贴到 GoLand 的Deployment path栏 -
Local path必须是你在 GoLand 里「File → Open」打开的那个目录的**完全相同路径**，大小写、空格、结尾斜杠都不能差 - 别用 Finder 或 VS Code 里看到的路径做参考——它们可能显示相对路径或自动隐藏
/Users前缀 - 改完立刻点
Tools → Deployment → Browse Remote Host，确认本地文件真传到了对应位置
远程 GOPATH/GOMODCACHE 没初始化导致 go run 失败
同步成功 ≠ 能跑。GoLand 只传源码，不传模块缓存、不初始化 go mod download、也不帮你设 GOPROXY。常见现象是远程终端执行 go run main.go 报错：cannot find module providing package，而本地一切正常。
实操建议：
- 连上虚拟机，cd 到项目目录，手动执行
go mod download（确保go.mod权限是当前用户可读写：ls -l go.*，必要时chown $USER:$USER go.*） - 检查远程
go env GOPATH和go env GOMODCACHE，确认路径存在且可写（mkdir -p $GOMODCACHE） - 如果用了私有模块或代理，远程也要配好
go env -w GOPROXY=https://goproxy.cn,direct - 别依赖 “上传即可用”——首次同步后，务必手动验证一次
go build是否通过
Remote Build 配置中 “Run on” 目标路径必须和 Deployment path 对齐
你在 Run Configuration 里选了 Run on remote machine，但填的 Working directory 是 /vagrant/myapp，而 Deployment 映射的是 /home/vagrant/myapp，GoLand 就会在错误路径下执行 go build，结果找不到 go.mod 或输出二进制到奇怪位置。
实操建议：
- Run Configuration →
Working directory的值，必须和 Deployment → Mappings 中的Deployment path**一字不差** - 编译输出路径（
-o参数）建议写成相对路径，比如./bin/myapp，避免硬编码绝对路径 - 如果远程项目用了
go.work，确保它也在映射范围内，且权限正确 - 点击
Manager Targets查看实际执行命令，确认工作目录和参数是否符合预期
自动上传失效的三个真实原因
勾了 Upload changed files automatically 却没同步？不是功能坏了，而是触发条件被卡住了。
实操建议：
- 检查是否设置了
On explicit save action—— 如果你关了自动保存（Ctrl+S才算“save”），那没按 Ctrl+S 就不会上传 - 右键项目根目录 →
Deployment → Upload to …手动试一次，看底部File Transfer窗口有没有报错（比如 Permission denied） - 遇到“Uploading…” 卡住，先点
File → Synchronize强刷本地状态，再重试；有时 IDE 缓存认为文件“未变”，其实已改 - 删除本地文件不会自动删远程——除非你主动勾选了
Delete remote files when local are deleted，这个默认是关闭的
pwd && ls 一眼确认。
