Java使用FileWriter创建含特殊字符标题的HTML文件失败问题

核心原因 #

Windows文件系统禁止文件名包含以下特殊字符：< > : " / \ | * ?，直接用带?的字符串作为文件名部分时，系统会拒绝创建文件。

解决方案 #

1. 替换特殊字符为合法字符

如果需要保留特殊字符的标识意义，可以自定义规则替换非法字符，比如将?替换为_q这类易识别的合法字符：

String title = "name?";
// 替换所有文件系统非法字符为自定义合法标识
String safeTitle = title.replaceAll("[<>:\"/\\\\|*?]", "_q");
File htmlContent = new File(InputFolder + File.separator + safeTitle + ".html");

2. 调整需求：将特殊字符放在HTML内容而非文件名

如果?是要在HTML页面的标题或内容中显示，而非作为文件名的一部分，应该把特殊字符写入HTML模板，而非文件名：

String title = "name";
// 将特殊字符放在HTML内容里
String template = "<html><head><title>name?</title></head><body><p>sooper</p></body></html>";
File htmlContent = new File(InputFolder + File.separator + title + ".html");

优化后的完整代码（自动关闭流避免资源泄漏） #

import java.io.File;
import java.io.FileWriter;
import java.io.IOException;

public class HtmlGenerator {
    public static void main(String[] args) {
        String template = "<p>sooper</p>";
        String inputFolder = "D:\\project";
        String title = "name?";
        
        // 处理非法文件名字符
        String safeTitle = title.replaceAll("[<>:\"/\\\\|*?]", "_q");
        File htmlContent = new File(inputFolder + File.separator + safeTitle + ".html");
        
        // 使用try-with-resources自动关闭FileWriter
        try (FileWriter myWriter = new FileWriter(htmlContent)) {
            myWriter.write(template);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

内容的提问来源于stack exchange，提问作者Akash Jayan Nair