GoLand中SFTP自动上传需手动开启，非默认行为；路径为Tools → Deployment → Automatic Upload并选Always或On explicit save，否则Ctrl+S不触发同步。
GoLand里SFTP自动上传必须手动开启，不是默认行为
很多人改完代码保存（Ctrl+S）后发现服务器没更新，是因为GoLand的Deployment功能默认关闭自动同步——它只提供“上传”动作入口，不监听文件变更。你得主动勾选Automatic Upload，否则每次都要右键→Upload to xxx。
开启路径：菜单栏 Tools → Deployment → Automatic Upload，然后选择 Always（推荐）或 On explicit save（仅在Ctrl+S时触发）。注意：这个选项不会出现在配置SFTP连接之后自动弹出，必须你手动点进去开。
常见错误现象：
- 点了
Automatic Upload但没生效 → 检查是否选了Always，而不是Off（默认就是Off） - 上传后远程文件权限异常或内容损坏 → 确认本地文件编码和换行符与服务器一致（尤其Windows开发机连Linux服务器时）
- 部分文件没同步 → 检查
Mappings中Deployment path是否填为/，否则子目录可能被排除
SFTP配置里Root path和Mappings填错，自动上传会静默失败
Root path是远程服务器上的绝对路径，比如/home/deploy/myapp；而Mappings里的Deployment path是相对于这个Root path的路径，通常填/表示本地项目根目录直接映射到远程Root path下。
如果填反了（比如把Root path写成./myapp），测试连接能过，但上传时会创建空目录或报No such file——因为SFTP协议不支持相对路径解析，它只认绝对路径。
关键验证步骤：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 配置完先点
Test Connection，成功只说明SSH通，不代表路径可用 - 再用
Tools → Deployment → Browse Remote Host打开远程目录树，确认绿色高亮区域正是你期望的Root path - 上传前右键项目名，看
Upload to xxx菜单里显示的服务器名是否和你命名的配置一致（比如test-server而非prod-server）
自动上传不校验差异，删本地文件不会删远程文件
GoLand的Automatic Upload本质是单向覆盖：本地有、远程没有 → 上传；本地改了 → 覆盖远程同名文件；但本地删了，远程还留着——它不做rsync --delete式清理。
这意味着：
- 如果你在本地重构目录结构（比如把
handlers/重命名为api/），旧目录仍会滞留在服务器上，可能引发运行时加载错误 - 误删
go.mod后自动上传，远程也会丢掉该文件，导致go build失败 - 没有冲突提示机制：A同事上传了
config.yaml，B同事本地改完保存，会直接覆盖A的版本
所以别把它当发布工具，只适合开发调试阶段的快速同步。上线前务必走完整构建+部署流程。
多个SFTP配置共存时，自动上传目标容易混淆
如果你配了test-server、staging-server、prod-server三个SFTP，Automatic Upload只会作用于当前“激活”的那个配置——而GoLand不显示哪一个是激活态，它取决于你最后一次在Browse Remote Host里打开的是哪个，或者上次点击Upload to xxx选的是哪个。
最稳妥的判断方式：
- 打开
Tools → Deployment → Configuration，看列表里哪个配置项左侧有蓝色对勾图标（表示默认部署目标） - 右键项目名，
Upload to xxx菜单里排第一的那个，就是当前自动上传的目标 - 想切换目标？必须去
Configuration里手动拖拽排序，或删掉不用的配置，避免误传
真正麻烦的不是配置多，而是“自动上传”状态不显式绑定到某个配置名上——它只认最后操作的那个，这点很容易被忽略，直到代码传到测试机上才发现跑的是旧版本。
