GoLand 的 PlantUML 渲染需手动配置 goplantuml、Graphviz 和 PlantUML 插件三件套，因其插件强制依赖本地 dot 命令且不支持云端回退；Graphviz 路径需显式配置并重启生效；goplantuml 对路径、符号链接和权限敏感；类图预览卡顿多因 .puml 语法错误或编码问题。
GoLand 默认不带 PlantUML 渲染能力，必须手动配齐 goplantuml + Graphviz + PlantUML 插件 三件套，缺一不可；否则打开 .puml 文件只会看到“Cannot Find Graphviz”或空白预览。
为什么 GoLand 不能像 VSCode 那样开箱即用？
VSCode 的 PlantUML 插件默认走云端渲染（无需本地 Graphviz），而 GoLand 的 PlantUML 插件（包括 JetBrains 官方维护的版本）强制依赖本地 dot 命令——也就是 Graphviz 的核心可执行文件。它不会 fallback 到在线服务，也不会自动下载内置二进制。
这意味着：哪怕你只写个最简单的 @startuml A --> B @enduml，只要没装好 Graphviz 并让 GoLand 找到它，就无法预览。
goplantuml 生成类图时常见的路径与权限问题
goplantuml 是 Go 项目专用的源码分析器，它本身不渲染图，只输出 .puml 文本。但它的行为对路径和权限很敏感：
- 如果用
-recursive扫描含符号链接的目录，可能报错permission denied—— 不是权限不足，而是它默认跳过 symlink，需加-follow-symlinks -
-output路径若指向不存在的父目录（比如docs/diagrams/xxx.puml），会静默失败，不报错也不生成文件 - 在 GoLand External Tools 中配置
Working directory时，别用$ProjectFileDir$这类变量——它可能被解析为空，导致goplantuml在根目录下运行并扫描整个磁盘 - macOS 上通过
brew install graphviz安装后，dot实际路径通常是/opt/homebrew/bin/dot（Apple Silicon）或/usr/local/bin/dot（Intel），不是插件界面里默认猜测的/usr/bin/dot
Graphviz 环境变量设置最容易漏掉的一步
即使你在终端里能跑通 dot -V，GoLand 仍可能找不到 dot，因为 GUI 应用不继承 shell 的 $PATH。必须显式设置环境变量：
在 GoLand 的 Help → Edit Custom Properties... 中添加：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
graphviz.dot=/opt/homebrew/bin/dot
或者（旧版 GoLand）在 Settings → Tools → PlantUML → Graphviz binary path 中填绝对路径。注意：GRAPHVIZ_DOT 系统级环境变量对 GoLand 无效，它只认自己配置项或 custom properties。
改完必须重启 GoLand——热重载不生效。
类图生成后预览卡在“Loading…”的真凶
这不是网络问题，大概率是 goplantuml 输出的 .puml 文件里用了 PlantUML 不支持的语法，比如：
- 未闭合的注释：
' 多行注释没写完 @enduml - 非法 Unicode 字符（尤其从其他编辑器粘贴过来的中文引号、破折号）
-
goplantuml默认开启-show-connection-labels，但某些 PlantUML 版本不识别该关键字，直接拒解析 - 文件编码不是 UTF-8（特别是 Windows 下用记事本保存过）
验证方法：把生成的 .puml 文件内容全选，粘贴到 PlantUML 在线编辑器，看是否报错。错在哪，就删哪行——通常就是一两个标点或空格的问题。
真正麻烦的从来不是装多少工具，而是每个环节都假设你知道它依赖什么、又不告诉你它到底卡在哪。比如 goplantuml 生成失败不提示，Graphviz 路径错不报错，PlantUML 插件加载失败只显示空白。盯住这三处日志和路径，比反复重装快得多。
