核心是“读模板→替换变量→写出文件”，需确保占位符唯一（如{{title}}）、所有外部输入html转义、全程utf-8编码，用inputstreamreader/outputstreamwriter而非filewriter，配合try-with-resources管理资源。
直接用字符流写HTML模板报告文件，核心是“读模板 → 替换变量 → 写出文件”，不依赖框架也能稳定可靠。关键不在流本身，而在于变量替换的准确性、编码一致性与内容安全性。
准备一个带占位符的HTML模板文件
先创建纯文本模板（如 report-template.html），用清晰、不易冲突的占位符，比如：
<h1>{{title}}</h1><br><p>生成时间：{{timestamp}}</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill9263" title="Html2md"><img
src="https://img.php.cn/upload/skill/000/000/081/179249945220127.jpg" alt="Html2md" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill9263" title="Html2md" class="overflowclass">Html2md</a>
<p class="overflowclass">使用 Readability + Turndown 将 HTML 页面转换为干净的、Agent 友好的 Markdown。去除导航栏、广告、页脚、Cookie 横幅、社交按钮等干扰元素。支持 URL...</p>
</div>
<a rel="nofollow" href="/xiazai/skill9263" title="Html2md" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div><br>
- {{items}}
避免使用
{{ 以外的模糊标记（如 $name 或 [name]），防止和CSS/JS语法或用户输入内容意外重叠。
用字符流读取并安全替换变量
以Java为例，推荐使用 InputStreamReader + BufferedReader 逐行读，配合 String.replace() 或正则替换（注意转义）：
- 按行读取，对每行调用
line.replace("{{title}}", "月度运营报告") - 对多值内容（如列表），先用Java集合生成HTML片段：
itemsHtml = list.stream().map(i -> "<li>" + escapeHtml(i) + "</li>").collect(Collectors.joining()) - 务必对所有用户来源或外部输入的内容执行HTML转义（
→<code><，"→"等），防止注入 - 统一使用UTF-8编码读写，避免中文乱码；构造
InputStreamReader(in, StandardCharsets.UTF_8)和OutputStreamWriter(out, StandardCharsets.UTF_8)
写出最终HTML报告文件
用 FileOutputStream + OutputStreamWriter 写入目标路径：
- 不要用
FileWriter——它默认使用系统编码，跨平台易出错 - 写入前确保目标目录存在：
Files.createDirectories(Paths.get("output")) - 写完调用
writer.flush()和writer.close()，或用 try-with-resources 自动释放 - 可选：写入后用
Desktop.getDesktop().browse()直接打开预览（仅限桌面应用）
进阶建议：提升健壮性与复用性
实际项目中可稍作封装，避免每次重复写替换逻辑：
- 把占位符定义为常量（
public static final String PLACEHOLDER_TITLE = "{{title}}";） - 封装一个
HtmlTemplateRenderer类，接收模板路径、变量Map、输出路径，内部完成读-替-写全流程 - 对复杂结构（如表格嵌套、条件区块），可引入轻量模板引擎（如Handlebars.java），但简单报告场景通常无需
- 生成后校验文件是否可被浏览器正常打开（例如检查是否含
和未闭合标签）
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
