GoLand 的 Markdown 预览不缓存 HTML,卡顿/不更新等问题源于渲染器或配置,非缓存导致;应调整 Parser、图片路径解析和数学公式渲染设置。

GoLand 没有 Markdown 实时预览缓存需要清理——它压根不缓存预览结果,每次渲染都是即时解析 HTML。 你看到的“卡顿”“样式错乱”“改了文件不更新”,几乎全是渲染器行为或插件状态问题,不是缓存堆积导致的。
为什么 Markdown 预览不会产生可清理的缓存
GoLand 的 Markdown 预览基于内置的 Swing 渲染器(非 Chromium),它不保存中间 HTML 或 CSS 文件到磁盘,也不维护 DOM 缓存。每次切换标签、重绘窗口、甚至焦点离开再回来,都会触发一次完整重解析。这意味着:
- 没有类似
$GOCACHE或$GOPATH/pkg/mod那样的目录存放“预览缓存” -
go clean系列命令对 Markdown 预览完全无效 - 手动去
~/Library/Caches/JetBrains/GoLand2026.2(macOS)里翻markdown相关子目录,只会看到日志或插件配置,找不到渲染产物
预览卡顿/异常的真实原因和应对方式
常见现象背后是具体可调的设置或冲突点:
-
大文件(>1MB)或含大量 inline HTML / 数学公式时卡顿:Swing 渲染器对复杂结构处理效率低,不是缓存问题,而是单线程解析瓶颈。解决办法是拆分文档,或在 Settings → Languages & Frameworks → Markdown → Preview 中关闭
Render math expressions -
改了 .md 文件,预览窗不刷新:检查 Settings → Tools → File Watchers 是否禁用了
Markdownwatcher;或者确认右下角预览窗右键菜单里没误点Auto-scroll from source而不是Auto-refresh -
代码块语法高亮错乱、表格渲染错位:大概率是启用了错误的 parser。Settings → Languages & Frameworks → Markdown → Parser 默认是
Flexmark,但若你装了旧版插件或手动切过Kramdown,会触发已知的表格解析 bug。强制设回Flexmark即可 -
图片路径显示为红叉,但文件明明存在:这不是缓存,是 GoLand 的资源路径解析逻辑在相对路径上出错。把图片路径从
./img/foo.png改成img/foo.png(去掉开头的.),或在 Settings → Languages & Frameworks → Markdown → Image path resolution 里勾选Resolve image paths relative to project root
唯一接近“缓存”的状态:插件级配置与历史记录
某些第三方 Markdown 插件(如 Markdown Navigator)会维护自己的状态,比如最近打开的预览页签、折叠的标题层级、自定义 CSS 注入等。这些数据存在 IDE 配置目录里,但属于用户偏好,不是构建缓存:
- macOS:
~/Library/Caches/JetBrains/GoLand2026.2/markdown-navigator(仅限装了该插件时) - Windows:
%LOCALAPPDATA%\JetBrains\GoLand2026.2\cache\markdown-navigator - Linux:
~/.cache/JetBrains/GoLand2026.2/markdown-navigator
删掉这个目录能重置插件行为(比如恢复默认折叠状态),但不会让预览“变快”或“更准”——它只影响 UI 状态,不影响解析逻辑。
真正要动的从来不是“缓存”,而是 parser 选择、路径解析策略、数学渲染开关这些开关级配置。别在 rm -rf 上浪费时间,直接去 Settings 里调三项:Parser、Image path resolution、Math rendering。


















