最稳妥方式是用内置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'''
<meta charset="utf-8"><title>{escape(title)}</title>{content}
''')
用 string.Template 管理多段 HTML 更清晰
当页面结构固定但部分区域常变(比如导航栏、页脚复用),硬拼 f-string 容易混乱。string.Template 是标准库轻量方案,比 jinja2 少一堆概念,又比纯字符串易维护。
注意:它不支持条件或循环,只做占位符替换;变量名必须是合法标识符,且调用 .substitute() 时所有占位符都得传值,否则报 KeyError。
- 把 HTML 拆成
header.html、footer.html等文件?没必要——string.Template本身不读文件,但你可以用Path.read_text()加载模板字符串 - 占位符写成
$title或${title}都行,后者在变量名后紧跟字母时更安全 - 如果某块内容可能为空(如副标题),先用
or ''补默认值,避免传None
from string import Template
template_str = '''
<title>$title</title><h1>$heading</h1>
$content
'''
t = Template(template_str)
html = t.substitute(
title="首页",
heading="欢迎光临",
content="<p>这是主页内容</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill7554" title="Galileo python sdk"><img
src="https://img.php.cn/upload/skill/000/000/081/179154376921467.jpg" alt="Galileo python sdk" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill7554" title="Galileo python sdk" class="overflowclass">Galileo python sdk</a>
<p class="overflowclass">Galileo AI 平台 Python SDK 完整参考,用于评估、监控和保护 GenAI 应用,适用于构建 Python 应用。</p>
</div>
<a rel="nofollow" href="/xiazai/skill7554" title="Galileo python sdk" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>"
)
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 结构
真要批量生成多个页面(比如博客文章、文档页),硬编码每个 ... 会迅速失控。这时候该考虑极简约定:只写正文内容,用脚本自动包裹基础结构。
关键点在于分离「内容」和「壳」——比如把 Markdown 文件转成 HTML 后,再套一层通用模板。否则每改一次页头,就得手动修几十个文件。
- 用
markdown库转正文,再用string.Template套壳,两步分离,逻辑干净 - 别在生成脚本里硬编码 CSS 路径,用相对路径(如
./style.css)并确保输出目录结构一致 - 如果部署到子路径(如
https://a.com/blog/),所有链接需带前缀,这时用配置项控制比全局搜索替换可靠
复杂点往往不在“怎么写进文件”,而在“怎么让不同页面共享样式、导航、元信息”。这些细节一旦忽略,后期补救成本远高于初期多花十分钟设计结构。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










