sublime text中diagram插件不显示display diagrams菜单项的根本原因是plantuml.jar下载不完整；mac提示“no working processors found!”是graphviz路径未显式配置；中文乱码需在user settings中设置charset和java_options为utf-8。
Sublime Text里Diagram插件不显示Display Diagrams菜单项
根本原因是sublime_diagram_plugin自带的plantuml.jar文件下载不完整，解压失败导致插件初始化异常。插件目录下diagram/plantuml.jar若大小明显偏小（比如不足1MB），基本就是这个原因。
解决方法很直接：
- 手动去PlantUML官方发布页下载最新
plantuml.jar（如plantuml.1.2024.10.jar） - 替换掉
Packages/sublime_diagram_plugin/diagram/plantuml.jar - 重启Sublime Text，
Preferences → Package Settings → Diagram → Display Diagrams就不再是灰色了
Mac上运行Diagram插件提示“No working processors found!”
这是Graphviz未被正确识别的典型报错，不是Java或jar的问题。即使dot -V在终端能正常输出版本，Sublime仍可能找不到它。
关键动作是显式配置路径：
- 先确认
dot位置：which dot（通常是/opt/homebrew/bin/dot或/usr/local/bin/dot） - 打开
Preferences → Package Settings → Diagram → Settings – User - 写入：
{ "dot_executable": "/opt/homebrew/bin/dot", "charset": "UTF-8" } - 不要依赖
GRAPHVIZ_DOT环境变量——Sublime插件不读系统环境变量
架构图中节点位置乱、连线重叠、文字截断
PlantUML默认布局对复杂架构图不友好，尤其含多层嵌套容器时。别硬调left to right direction，优先用显式定位语法。
实用技巧：
- 用
[ComponentA] as A定义别名，后续连线写A --> B更清晰 - 强制方向：用
-up->、-right->替代默认箭头，例如WebServer -right-> APIGateway - 容器内居中：给
package或frame加skinparam defaultFontSize 14防文字挤压 - 避免自动换行：长文本加双引号并启用
skinparam wrapWidth 300
生成PNG后中文显示为方块或乱码
根本不在字体设置，而在PlantUML渲染时的字符集声明缺失。插件默认用系统locale，但macOS和Windows的默认编码常不一致。
必须在Diagram插件的User Settings里锁定编码：
- 打开
Preferences → Package Settings → Diagram → Settings – User - 确保包含：
{ "charset": "UTF-8", "java_options": "-Dfile.encoding=UTF-8" } - 如果仍异常，再补一句
skinparam defaultFontName "Helvetica"（避免调用系统中缺失的中文字体）
架构图真正难的不是语法，而是让每个package、node、[ ]块在渲染时按你预期的位置和尺寸出现——这需要反复微调-down->和skinparam nodesep 20这类细节，而不是一上来就堆逻辑。
