GoLand SFTP自动同步需同时启用“Upload changed files automatically”和“On explicit save action”（位于Tools → Deployment → Options），且路径映射必须严格一致、远程文件可写、首次使用需手动全量上传。
GoLand SFTP自动同步必须同时开启两个开关
只勾选 Upload changed files automatically 不起作用——它默认不响应 Ctrl+S。真正触发“一保存就传”的，是 On explicit save action 这个触发时机选项，它藏在 Tools → Deployment → Options 里，不是主配置页。
常见卡顿现象：按 Ctrl+S 后状态栏显示 “Uploading…” 却一直不动，或完全没反应。大概率就是漏选了这个下拉项。
- 确认
Tools → Deployment → Options中已勾选Upload changed files automatically - 其下方的下拉菜单必须选
On explicit save action（不是On file save，后者在 GoLand 2026.1.1 及部分旧版中无效） - 如果右键文件没有
Deployment → Upload to …菜单，说明当前 Deployment 配置根本未启用，先去Tools → Deployment → Configuration检查是否勾选了你的配置
路径映射必须严格一致，结尾斜杠不能错
本地路径 /home/user/myproj 和远程路径 /home/user/myproj/（多一个 /）会被某些 SFTP 服务视为不同路径，导致静默失败：GoLand 认为“本地有变更、远程无对应路径”，直接跳过上传，也不报错。
典型场景：你在 WSL 或 macOS 开发，部署到 Ubuntu 远程服务器；或用 Docker 挂载目录做构建。路径不一致时，同步就不可靠。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
pwd确认本地绝对路径 - 用
ssh user@host 'pwd'确认远程目标路径 - 两边都不要加尾部
/，除非你明确需要（比如远程是/var/www/html/这类 Web 根目录约定） - 检查
Tools → Deployment → Configuration → Mappings标签页，逐字符比对
go.mod 权限错误会导致上传成功但内容未更新
同步过程只判断 SFTP Write 调用是否返回 nil，不校验磁盘实际写入权限。如果远程 go.mod 或 go.sum 属于 root:root，而你用普通用户连接 SFTP，上传会“成功”完成，但文件内容没变。
表现：改完 go.mod 保存后，GoLand 显示上传完成，但远程执行 go build 仍报依赖未更新；ls -l go.* 会发现时间戳没变。
- 用
ssh user@host 'ls -l go.*'检查远程文件属主和权限 - 确保远程项目目录对当前 SFTP 用户可写：
chmod u+w . && chmod u+w go.* - 若必须由 root 管理，考虑改用
sudo -u youruser启动 SFTP 服务，或换用 root 用户连接（不推荐）
首次同步建议手动全量上传，别依赖自动同步启动
自动同步是增量逻辑，它依赖本地与远程已有文件状态的一致性。如果远程目录为空或结构不完整，第一次保存可能漏传关键文件（如 main.go、go.mod），导致后续编译失败。
尤其在新服务器、新项目、或清理过远程目录后，务必先手动触发一次全量同步。
- 在项目根目录右键 →
Deployment → Upload to … - 或使用
Tools → Deployment → Upload to … - 观察底部
File Transfer窗口，确认所有文件都已上传成功 - 上传完成后，再开始日常的 Ctrl+S 自动同步
最易被忽略的是：自动同步不处理权限、不校验内容、不修复路径错位——它只负责把“看起来该传的文件”按映射关系推过去。路径、权限、初始一致性这三件事，得人来兜底。
