最稳妥方式是用内置open()配合f-string或string.Template，指定encoding='utf-8'并用html.escape()转义用户输入；pathlib.Path.write_text()更简洁安全，适合单文件生成。
用 open() 和字符串拼接最直接
生成 index.html 文件本质就是写入文本，Python 里最稳妥的方式是用内置 open() 配合普通字符串或 f-string。别一上来就找模板引擎——小项目反而增加依赖和出错概率。
常见错误是忘记指定 encoding='utf-8'，导致中文乱码或写入失败；还有用 'w' 模式时没注意会清空原文件（哪怕它不存在）。
- 确保路径可写：比如当前目录下执行，就直接写
'index.html'；若要写到./dist/index.html，先用os.makedirs('./dist', exist_ok=True) - HTML 标签必须闭合，
<meta charset="utf-8">别漏，否则浏览器可能不认中文 - 如果内容含用户输入（如标题、描述），记得用
html.escape()转义，防 XSS 或标签断裂
from html import escape
title = "我的首页"
content = "<p>欢迎访问</p>"
with open('index.html', 'w', encoding='utf-8') as f:
f.write(f'''<!DOCTYPE html>
<html>
<head><meta charset="utf-8"><title>{escape(title)}</title></head>
<body>{content}</body>
</html>''')
用 string.Template 管理多段 HTML 更清晰
当页面结构固定但部分区域常变（比如导航栏、页脚复用），硬拼 f-string 容易混乱。string.Template 是标准库轻量方案，比 jinja2 少一堆概念，又比纯字符串易维护。
注意：它不支持条件或循环，只做占位符替换；变量名必须是合法标识符，且调用 .substitute() 时所有占位符都得传值，否则报 KeyError。
立即学习“Python免费学习笔记（深入）”；
- 把 HTML 拆成
header.html、footer.html等文件？没必要——string.Template本身不读文件，但你可以用Path.read_text()加载模板字符串 - 占位符写成
$title或${title}都行，后者在变量名后紧跟字母时更安全 - 如果某块内容可能为空（如副标题），先用
or ''补默认值，避免传None
from string import Template
template_str = '''<!DOCTYPE html>
<html>
<head><title>$title</title></head>
<body>
<h1>$heading</h1>
$content
</body>
</html>'''
t = Template(template_str)
html = t.substitute(
title="首页",
heading="欢迎光临",
content="<p>这是主页内容</p>"
)
with open('index.html', 'w', encoding='utf-8') as f:
f.write(html)
用 pathlib.Path.write_text() 替代 open() 更简洁
Python 3.4+ 推荐用 pathlib 处理路径操作。Path.write_text() 自动处理编码和关闭文件，代码更短，出错率更低——尤其适合生成单个 HTML 文件这种简单任务。
容易踩的坑：write_text() 默认用 utf-8，但如果你显式传了 encoding 参数，就必须和内容实际编码一致；另外它不支持追加模式（a），只能覆盖写。
- 路径对象支持链式操作，比如
Path('dist').joinpath('index.html').write_text(...) - 如果想确保父目录存在，加
parent.mkdir(parents=True, exist_ok=True) - 别对同一
Path对象反复调用write_text()——它每次都是全量重写，不是增量更新
from pathlib import Path
html_content = '<h1>Hello</h1>'
output_path = Path('dist/index.html')
output_path.parent.mkdir(parents=True, exist_ok=True)
output_path.write_text(html_content, encoding='utf-8')
生成静态站点时，别手写完整 HTML 结构
真要批量生成多个页面（比如博客文章、文档页），硬编码每个 <html>...</html> 会迅速失控。这时候该考虑极简约定：只写正文内容，用脚本自动包裹基础结构。
关键点在于分离「内容」和「壳」——比如把 Markdown 文件转成 HTML 后，再套一层通用模板。否则每改一次页头，就得手动修几十个文件。
- 用
markdown库转正文，再用string.Template套壳，两步分离，逻辑干净 - 别在生成脚本里硬编码 CSS 路径，用相对路径（如
./style.css）并确保输出目录结构一致 - 如果部署到子路径（如
https://a.com/blog/），所有链接需带前缀，这时用配置项控制比全局搜索替换可靠
复杂点往往不在“怎么写进文件”，而在“怎么让不同页面共享样式、导航、元信息”。这些细节一旦忽略，后期补救成本远高于初期多花十分钟设计结构。
