文件树不更新通常因未启用Always Select Opened File，而非缓存问题；Go模块索引滞后需检查右下角状态栏并执行Reload project；清缓存仅删index和caches目录；SFTP同步失败多因Deployment配置错误或权限问题。
GoLand文件树不更新，不是缓存问题而是同步开关没开
文件树不随磁盘变化自动滚动或高亮当前文件，90% 是因为 Always Select Opened File 未启用，和缓存无关。这个选项控制的是“编辑器焦点切换时，左侧项目树是否自动定位到当前打开的文件”，它不依赖索引或缓存刷新，纯 UI 行为。
进入 Settings/Preferences → Appearance & Behavior → System Settings，勾选 Always Select Opened File 即可。关闭该选项后，哪怕你双击打开 main.go，文件树仍可能停在上次展开的位置，看起来像“没刷新”。
常见误判：改完文件发现文件树没跳转，就去清缓存、重载项目、甚至删 .idea 目录——其实只是少点了一次勾选。
文件内容变更后 IDE 不识别，先查 Go modules 索引状态
编辑器里看到的代码和磁盘实际内容不一致（比如删了某行，但 Ctrl+B 还能跳转过去；或改了函数签名，Find Usages 仍返回旧结果），大概率是 Go 模块索引滞后，而非通用缓存脏了。
检查右下角状态栏是否显示 Go modules，且图标为绿色正常态；若显示 Indexing... 或灰色，说明解析尚未完成。
- 右键项目根目录 →
Go → Change Directory to Module Root，确保go.mod被正确识别 - 执行
File → Reload project from disk，强制触发模块重解析（比清缓存快得多） - 如仍无效，在
Go → Settings → Go Modules中确认Enable Go Modules integration已勾选
注意：Reload project 不会丢失未保存修改，但它会丢弃当前的符号引用缓存，重新构建整个包依赖图——这是最接近“精准清理”的操作，比盲目删 system/caches 有效十倍。
真要清缓存？只清 index 和 caches，别碰 plugins
当遇到极少数情况：索引反复失败、跳转错乱、符号搜索完全无响应，且 Reload project 无效时，才考虑手动清缓存。但必须精确到目录，否则重装插件、重配 GOPATH 都得重来。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
关闭 GoLand 后，进入用户配置目录（路径因系统而异）：
- macOS：
~/Library/Caches/JetBrains/GoLand202X.X/index和caches - Windows：
%LOCALAPPDATA%\JetBrains\GoLand202X.X\caches和index - Linux：
~/.cache/JetBrains/GoLand202X.X/index和caches
删除这两个文件夹即可。不要删 plugins 或 config，前者会导致所有插件重装，后者会丢失自定义快捷键和模板。
重启后首次打开项目会明显变慢——这是 IDE 在重建索引，属正常现象。若数分钟后仍卡在 Indexing...，检查 go.mod 是否有循环依赖或非法 replace 指令。
SFTP 同步失败时的“假缓存”陷阱
你以为是本地缓存没刷导致远程不同步，其实是 Deployment 配置根本没生效，或者路径映射错位——这种情况下清缓存毫无意义。
验证步骤：
- 右键任意文件 → 看是否有
Upload to …菜单项；没有说明Deployment configuration未启用 - 进
Tools → Deployment → Configuration，确认对应配置右侧启用了✔ - 重点核对
Local path和Deployment path的结尾斜杠：本地是/home/user/myproj，远程就不能填/home/user/myproj/ - 检查
Tools → Deployment → Options中是否同时勾选Upload changed files automatically和On explicit save action
最隐蔽的坑：go.mod 文件权限为只读，或远程目录 chmod 755 但用户无写权限，此时上传静默失败，状态栏不报错也不提示——它连“缓存要不要刷”这一步都跳过了。
