核心用法
lh-html-to-image 是一款基于 Chrome 无头浏览器截图的本地化图片生成工具。用户编写标准 HTML+CSS 代码,通过命令行调用 Chrome 的 --screenshot 参数即可输出 PNG 图像。无需依赖外部 API,完全离线运行。
典型工作流:
1. 创建包含内联 CSS 的 HTML 文件,定义画布尺寸(如 1080×1440)
2. 执行 Chrome 命令行截图指令,支持 macOS/Linux 双平台
3. 通过 --force-device-scale-factor 控制输出分辨率(1x/2x)
显著优点
- 零成本:无 API 调用费用,无速率限制
- 像素级精准:浏览器级文本渲染,字体、排版、换行完全可控
- 高 DPI 输出:支持 Retina 2x 缩放,满足印刷级清晰度
- CJK 友好:内置 PingFang SC、Noto Sans SC 等中文字体方案
- 灵活尺寸:覆盖 1:1、3:4、16:9 等常见社交媒体比例
局限性与风险
- 技术门槛:需掌握 HTML/CSS,非可视化操作
- 环境依赖:必须安装 Chrome/Chromium,Linux 需额外配置字体
- 无动态内容:不支持 JavaScript 渲染后的截图
- 本地文件限制:
file://协议可能受浏览器安全策略影响
适合人群
- 开发者/设计师:需要程序化生成标准化视觉素材
- 内容运营:批量制作封面图、数据卡片、金句海报
- 追求精准排版的用户:对 AI 生图的文字乱码感到困扰
常规风险提示
- GPU 错误日志属正常现象,可安全忽略
- 复杂布局建议先在常规浏览器预览再截图
- 跨平台字体回退需提前测试