需要把源码生成语法高亮代码片段图片时，用…

适用于想生成代码截图、把代码转成可分享图片，或为文档/社交帖子批量生成漂亮代码片段，并需要可复用配置时。

适用场景

解决思路

1. 无配置快速渲染单文件为 PNG：运行 `npx snipgrapher render file.ts -o output.png`。
2. 需要持续使用时，先初始化项目配置再渲染：运行 `npx snipgrapher init` 创建 `snipgrapher.config.json`，然后运行 `npx snipgrapher render file.ts --profile default -o output.png`。
3. 渲染后确认输出成功：运行 `ls -lh output.png`，确认文件存在且大小大于 0，再把任务视为成功。
4. 按顺序阅读并遵循 `rules/setup-and-configuration.md`，其中涵盖安装、选择可执行文件、初始化配置和定义 profiles。
5. 按顺序阅读并遵循 `rules/rendering-workflows.md`，其中涵盖渲染单个片段、批处理任务、watch 模式和输出实践。
6. 配置优先：在重复渲染之前先建立项目配置。
7. 可复现输出：优先使用命名 profiles 和显式输出路径。
8. 可移植命令：使用能同时兼容已安装二进制和 `npx` 的命令模式。
9. 面向自动化：有意依赖 CLI flags、配置和环境变量的优先级。
10. 排查缺失字体：确保 profile 或配置中指定的任何自定义字体已安装在系统中。
11. 排查不支持的语法：确认语言/扩展受 snipgrapher 支持；若不支持，回退到纯文本高亮。
12. 排查空或损坏输出：如果支持 `--verbose`，重新运行 `--verbose` 以暴露错误细节，并验证输入文件可读且非空。
13. 排查找不到 profile：如果配置文件缺失或格式错误，运行 `npx snipgrapher init` 重新生成 `snipgrapher.config.json`。

适用边界 · 注意事项

• 无法使用 npm/npx 或无法安装、运行 snipgrapher 时。
• 只需要代码文本、运行代码或做语法检查，而不需要生成图片时。
• 系统缺少所需自定义字体且无法安装，或源码语言不受支持且不接受纯文本高亮时。