WebView加载本地HTML时资源路径错误，因相对路径按JVM工作目录而非HTML所在目录解析；应使用绝对file:// URI加载，并确保CSS/JS/image与HTML同级或用getResource()嵌入资源。
WebView加载本地HTML时资源路径出错
JavaFX的WebView默认以file://协议加载HTML，但CSS/JS/image等相对路径会按当前JVM工作目录解析，不是HTML文件所在目录——这导致预览页面样式丢失、脚本不执行。
- 用
WebEngine.load(Paths.get("preview.html").toUri().toString())，确保URI是绝对路径且含file://前缀 - 避免直接用
load("preview.html")，它会被当成HTTP路径处理 - 如果HTML里引用了
./style.css，需确认该CSS和HTML在同级目录；否则改用getClass().getResource("/static/style.css").toExternalForm()嵌入资源
Markdown转HTML必须同步到WebView且避免XSS
不能把原始Markdown字符串直接拼进HTML再load()，既不安全也不可控。推荐用WebEngine.executeScript()注入内容，绕过HTML解析阶段。
- 先用
commonmark库（如Parser+HtmlRenderer）将Markdown转为纯净HTML字符串 - 在WebView加载完后，调用
webEngine.executeScript("document.body.innerHTML = " + JSON.stringify(htmlStr))，注意用JSON.stringify自动转义引号和尖括号 - 禁用
HtmlRenderer的escapeHtml(true)（默认开启），否则<code>标签会被双重转义成<code>
实时预览卡顿或光标错位
每次输入都全量重渲染整个HTML体，会导致滚动位置丢失、焦点跳脱、性能下降——尤其在长文档或频繁输入时明显。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 只更新
<div id="preview-content">内部HTML，而非整个<code>body；提前在HTML模板中写好这个容器 - 用
webEngine.executeScript("document.getElementById('preview-content').innerHTML = ...")替代load() - 监听
TextArea的textProperty()变化，但加个PauseTransition防抖（比如300ms内只触发最后一次） - 不要在WebView未完成加载前调用
executeScript()，否则报java.lang.IllegalStateException: Not on FX application thread或空指针 - 检查运行时是否包含
--add-modules javafx.web和--add-exports相关参数 - 若用JDK 17+，必须用Gluon或OpenJFX 17+配套包，否则
new WebView()直接抛NoClassDefFoundError - 预览页中避免依赖
window.location或fetch——WebView对现代API支持不一致，优先用同步XMLHttpRequest或纯客户端逻辑
JavaFX WebView在不同JDK版本渲染差异大
JDK 11+移除了内置WebView（WebEngine基于WebKit），需额外引入javafx-web模块；而JDK 8自带但已停止更新，某些CSS Grid或ES6语法可能不支持。
立即学习“Java免费学习笔记（深入）”；
