goland远程同步需手动配置路径映射、启用“on explicit save action”触发上传，并确认远程权限与路径一致性；删除本地文件不会自动清理远程，需勾选对应选项；同步成功后须手动执行go mod tidy。
GoLand 的远程代码同步不是“连上就自动实时”，必须手动配对路径、启用触发时机、绕过缓存陷阱，否则改了本地文件，远程压根没变。
Deployment 配置里路径映射必须严格一致
GoLand 不会智能推断路径关系，Mappings 里的 Local path 和 Deployment path 差一个 / 或大小写，上传就静默失败。
- 检查方式：右键项目根目录 →
Deployment → Browse Remote Host，看打开的远程路径是否和Deployment path完全一样（包括结尾斜杠） - 常见错误：
/home/user/myprojvs/home/user/myproj/—— 某些 SFTP 服务端把它们当两个不同路径处理 - 建议统一用不带尾部
/的写法，例如/home/user/myproj，并在远程终端里ls -ld /home/user/myproj确认权限属于当前 SSH 用户
自动上传必须绑定“显式保存”动作
默认的 Upload changed files automatically 如果选错触发条件，会漏传或误传。它不响应编辑过程中的自动保存（Auto Save），只响应你真正按下 Ctrl+S 或失焦时的“显式保存”。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 正确设置路径：
Tools → Deployment → Options → Upload changed files automatically → On explicit save action - 别选
On file change：它依赖文件系统 inotify，远程服务器上不可用；本地监听又无法感知远程修改 - 如果想“几乎实时”，配合
File → Settings → Appearance & Behavior → System Settings → Save files on frame deactivation+Save files automatically if application is idle for N sec（比如设为 1 秒），再配上上面的On explicit save action，效果接近所见即所得
同步失败时先手动刷新再查原因
GoLand 的 Deployment 缓存可能卡住，显示“已上传”但远程实际没更新，尤其在频繁切换分支或重命名文件后。
- 第一步永远是：
File → Synchronize，强制重新比对本地与远程状态 - 第二步看
Tools → Deployment → Browse Remote Host，直接翻到对应文件，确认内容是否真变了 - 第三步查日志：
View → Tool Windows → Deployment Console，里面会打印每一步上传的 HTTP/SFTP 状态码，403是权限不足，550是目标目录不存在或无写权限 - 特别注意：
go.mod和go.sum若属root:root，普通用户上传会被拒绝且无提示——用ls -l go.*在远程终端确认
删除本地文件不会自动清理远程，要额外勾选
默认行为是“只增不减”，这防止误删，但也容易让远程残留废弃文件，尤其重构后。
- 如需双向同步删除，进
Tools → Deployment → Options，勾选Delete remote files when local are deleted - 该选项仅对已纳入 Deployment 映射的文件生效；未被映射的远程文件（比如
build/下的产物）永远不会被清理 - 勾选后，删除前会有二次确认弹窗，不能跳过——这是唯一防手滑机制，别试图关掉
最常被忽略的是：同步成功不等于能运行。GoLand 只传文件，不传 go env、不拉依赖、不执行 go mod tidy。远程第一次上传完，务必 ssh 进去 cd 到项目目录，手动跑一次 go mod tidy，否则 go run 必报 cannot find module providing package。
