Java中使用InputStreamReader读取模板文件时，必须显式指定UTF-8编码以避免乱码，推荐搭配BufferedReader提升效率，并通过try-with-resources确保资源及时关闭。
在 Java 中使用 InputStreamReader 读取模板引擎（如 FreeMarker、Velocity 或自定义文本模板）文件时，核心目标是**正确解码字节流为字符流**，避免乱码。关键不在于 InputStreamReader 本身“转换模板”，而在于它作为桥梁，把底层文件的字节按指定编码转成可被模板引擎处理的字符串内容。
明确文件真实编码，显式指定 charset
模板文件（如 email.ftl、report.vm）通常以 UTF-8 保存，但 Windows 环境下可能默认为 GBK。若未指定编码，InputStreamReader 会使用平台默认编码（如 Windows 的 GBK），导致 UTF-8 文件读取乱码。
- ✅ 正确做法：始终通过
StandardCharsets.UTF_8或"UTF-8"显式传入构造器 - ❌ 避免：
new InputStreamReader(inputStream)（依赖系统默认编码，不可靠） - 示例：
new InputStreamReader(new FileInputStream("template.ftl"), StandardCharsets.UTF_8)
配合 BufferedReader 提升读取效率与易用性
InputStreamReader 是字符流起点，但直接 read() 逐字符读效率低。模板内容一般需整段加载，推荐包装为 BufferedReader：
- 用
readLine()按行读取，适合解析带结构的模板（如含<#if>的 FreeMarker） - 用
lines().collect(Collectors.joining("\n"))一次性读取全文（Java 8+） - 注意：
BufferedReader不改变编码逻辑，只优化 I/O，编码仍由InputStreamReader决定
与模板引擎 API 无缝对接
多数现代模板引擎（如 FreeMarker）支持直接从 Reader 加载模板，无需先转成 String：
立即学习“Java免费学习笔记（深入）”；
- FreeMarker：
cfg.getTemplate("name", "UTF-8", new InputStreamReader(is, StandardCharsets.UTF_8)) - Velocity：
engine.evaluate(context, writer, "template", reader)（reader 即 InputStreamReader 实例） - 若引擎只接受 String，则用
StringWriter+IOUtils.copy()（Apache Commons）或手动拼接
资源必须及时关闭，避免文件句柄泄漏
模板文件流属于外部资源，未关闭会导致后续读取失败或内存泄漏：
- 推荐 try-with-resources：自动关闭
InputStreamReader和其底层FileInputStream - 示例：
try (InputStream is = getClass().getResourceAsStream("/templates/email.ftl"); InputStreamReader reader = new InputStreamReader(is, StandardCharsets.UTF_8); BufferedReader br = new BufferedReader(reader)) { String content = br.lines().collect(Collectors.joining("\n")); // 交给模板引擎处理 }
