结构工具窗口通过alt+0+7或「视图|工具窗口|结构」打开,仅显示当前编辑器中已打开且获得焦点的文件结构;文件结构弹出窗口按ctrl+f12调用,轻量快捷。

结构工具窗口怎么打开
直接按 Alt+0+7(数字小键盘上的 7),或者从顶部菜单选「视图|工具窗口|结构」。它只显示当前编辑器中**已打开且获得焦点**的文件结构,不是整个项目——这点常被误以为是“项目大纲”,其实不是。
如果你只想临时看一眼、不占空间,用弹出式窗口更轻量:按 Ctrl+F12(文件结构弹出窗口),松手就收,适合快速跳转函数或类型声明。
结构树里看不到私有字段或其它文件的定义
默认情况下,GoLand 的结构视图会隐藏未导出的标识符(比如小写开头的 foo 字段或方法),也不会跨文件显示同包其他源码。这不是 bug,是设计行为。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 要显示当前文件里的私有成员:点击结构窗口右上角的齿轮图标 → 勾选「显示私有成员」
- 要看到整个包(不止当前文件)的结构:勾选「显示包结构」——但注意,这仅限于当前模块下已索引的 Go 文件,未被
go mod管理或未在 GOPATH 中的文件不会出现 - 如果勾了「显示私有成员」但还是没看到某个字段,检查它是否真的在当前文件里定义;Go 的嵌入字段或匿名结构体成员可能不会单独列出来
结构树排序和导航不按预期工作
结构树默认按声明顺序排列,不是字母序,也不是作用域层级。你点某个函数名,光标不一定跳到定义处——这取决于「单击导航」是否启用。
- 确保结构窗口标题栏右侧的「单击导航」按钮是高亮状态(图标类似箭头进入方框)
- 想让编辑器里点代码时结构树自动定位到对应项:勾选「始终选择已打开元素」
- 排序只影响视觉呈现,不影响搜索或跳转逻辑;「按字母顺序」对调试无帮助,但方便人工扫读;「按可导出性」把大写开头的放前面,更适合快速找公开 API
- 结构树不支持模糊搜索,想搜字段名请用
Ctrl+F或结构化搜索(Ctrl+Shift+A→ 输入「Structural Search」)
结构树响应慢或不更新
常见原因是文件未被正确识别为 Go 源码,或项目索引未完成。尤其当你刚加了一个 .go 文件但没出现在结构树里,大概率是 IDE 还没把它纳入分析范围。
- 确认文件后缀是
.go,且文件顶部没有非法 UTF-8 字符或 BOM 头 - 检查右下角状态栏是否显示「Indexing…」;等待索引完成再试
- 如果长期卡住,尝试
File → Reload project from disk或手动触发索引重建:File → Invalidate Caches and Restart → Invalidate and Restart - 结构树本身不缓存远程或未打开的文件内容,所以别指望它显示 git stash 里的变更或未保存的编辑










