plantuml插件装不上需先确认sublime text 4的python路径匹配及java环境：检查控制台import sys; print(sys.executable)输出是否有效，确保plantuml.jar路径无中文空格，文件后缀为.puml，代码块以@startuml开头、@enduml结尾，禁用server模式直连jar，并配置正确graphviz_dot与中文字体。
PlantUML插件装不上？检查Python路径和Sublime Text架构匹配
Sublime Text 4 默认不带Python运行时，而PlantUML插件（如PlantUML或Sublime-PlantUML）依赖本地java命令和plantuml.jar，但更关键的是：插件启动时会调用Python脚本做路径解析、HTTP请求或临时文件管理。如果你用的是Sublime Text 4（64位），而系统Python是32位，或者PATH里没有包含Python可执行文件，插件就会静默失败——没报错，也没预览窗口。
- 打开Sublime Text控制台（
Ctrl+`），输入import sys; print(sys.executable)，确认输出的是你期望的Python路径（比如/usr/bin/python3或C:Python39python.exe） - 如果输出为空或报错，说明Sublime没加载到Python；这时不要硬改
PATH，而是用Package Control: Install Package重装插件，并在安装前确保系统已安装Python 3.7+ - Windows用户特别注意：
plantuml.jar路径中不能含中文或空格；推荐放在C:plantumlplantuml.jar，并在插件配置里显式指定"plantuml_jar": "C:/plantuml/plantuml.jar"（用正斜杠，不是反斜杠）
写完时序图没反应？检查语法格式和代码块标记
PlantUML在Sublime里不是“所见即所得”，它靠识别特定代码块触发渲染。常见失效原因是：没写对起始标记、缩进错位、或混用了Markdown风格的反引号。
- 必须以
@startuml开头，以@enduml结尾，中间不能有空行打断（尤其注意复制粘贴时带的不可见字符） - 不要用
```plantuml或~~~包裹——那是Markdown渲染器用的，Sublime PlantUML插件只认纯文本中的@startuml块 - 时序图里参与者定义要顶格写，比如
actor User，不能缩进；而消息箭头（User -> Server: login()）可以缩进，但所有行都得用英文标点、半角字符 - 如果保存后右键菜单里没有
Preview PlantUML选项，说明插件根本没识别当前文件为PlantUML——把文件后缀改成.puml或.pu，或手动设置语法高亮为PlantUML
预览图模糊/字体小/中文乱码？调整Graphviz和字体配置
PlantUML默认用Graphviz渲染时序图，而Graphviz的字体路径、DPI设置、以及Java的字体渲染策略，都会直接影响输出质量。中文乱码几乎100%是因为Java没加载到中文字体。
- 确认已安装Graphviz，并在系统
PATH中可调用dot -V；Sublime插件配置里设"graphviz_dot": "/usr/local/bin/dot"（macOS）或"graphviz_dot": "C:\Program Files\Graphviz2.38\bin\dot.exe"（Windows） - 在PlantUML代码顶部加配置语句：
skinparam defaultFontName "Microsoft YaHei"（Windows）或"PingFang SC"（macOS），并确保该字体系统已安装 - 导出PNG时默认DPI偏低，可在
@startuml后加skinparam dpi 150提升清晰度；若仍模糊，说明Graphviz输出被压缩，此时改用SVG输出（插件配置中设"output_format": "svg"）
想一键导出PNG却提示“Connection refused”？绕过HTTP服务直连JAR
很多插件默认走http://localhost:8080调PlantUML Server，但本地没启服务就必然失败。其实没必要跑服务——直接调用java -jar plantuml.jar更稳、更快、也更容易调试。
- 关闭插件里的
"use_server"选项（设为false） - 确保
"java_bin"指向正确Java路径（如/usr/bin/java），且Java版本≥8（PlantUML 1.2023+要求Java 11+） - 导出时插件会生成临时
.puml文件，然后执行类似java -jar plantuml.jar -tpng /tmp/file.puml；如果终端里手动运行这行命令能出图，但Sublime里不行，八成是插件工作目录权限问题——把项目根目录设为可写，或改用绝对路径的cache_dir配置
真正卡住的地方往往不是语法，而是Java环境、字体链路、或插件对临时文件的路径处理——遇到问题先看控制台输出，而不是重写图。
