直接答案：先用最小 SVG 文件固定 width、height 和 viewBox，再添加基本图形、分组与文本；用浏览器和 XML 解析器检查结构，缩放到 390px 验证不裁切。复杂图表还要在 HTML 中保留等价结论，不能只把关键信息画进图片。
本文面向需要做技术选型或落地验收的中文读者。所有会随版本变化的接口、价格、硬件支持和功能可用性，都应在实施当天回到官方页面复核；本文复核日期为 2026-09-10。
先判断：这个任务真正要解决什么
在 Windows 与现代浏览器中写出可缩放、可验证并带可访问文本的 SVG。开始前把业务目标写成可验证条件，避免把“能运行”“返回了结果”误当成质量达标。
| 序号 | 决策问题 | 验收方式 |
|---|---|---|
| 1 | 环境为 Windows 11、Python 3.13 与 Chromium | 记录证据、负责人和通过条件 |
| 2 | SVG 命名空间、viewBox 和尺寸 | 记录证据、负责人和通过条件 |
| 3 | 文本替代、对比度和缩放 | 记录证据、负责人和通过条件 |
| 4 | XML 可解析且浏览器无裁切 | 记录证据、负责人和通过条件 |
核心原理与适用边界
- viewBox 定义内部坐标系，width 和 height 定义默认视口。
- SVG 是 XML，标签闭合和转义错误会阻断解析。
- 可访问名称不能只依赖文件名或周围猜测。
这些原则只说明技术机制，不代表任何特定产品在你的数据、硬件或组织流程中必然更快、更准或更省。若官方材料没有披露某项实现，应明确标为未知，而不是根据营销名称推断。
从基线到上线的执行步骤
- 第 1 步：新建带 xmlns 与 viewBox 的最小文件
- 第 2 步：添加 rect、path、text 和分组
- 第 3 步：为图形写 title、desc 与周围等价文字
- 第 4 步：用 Python XML 解析器验证
- 第 5 步：在 1200px 与 390px 浏览器渲染
- 第 6 步：保存源 SVG 与 WebP 预览并记录指纹
每一步都要保存输入版本、配置、输出和验收结论。遇到失败先缩小范围并保留原始证据，不要为了让演示通过而修改测试口径。
建议保存的验收记录
| 记录项 | 最低要求 | 失败时处理 |
|---|---|---|
| 范围与版本 | 代码、数据、模型、依赖、硬件和日期可追踪 | 冻结发布，补齐版本后重跑 |
| 质量证据 | 与固定基线按相同输入和指标比较 | 定位数据、提示、模型或系统层原因 |
| 安全与权限 | 最小权限、敏感数据处理、失败模式均有验证 | 撤销权限或回滚到安全版本 |
| 发布与恢复 | 灰度范围、监控阈值、负责人和回滚命令明确 | 停止扩量并执行已演练的回滚 |
常见风险与失败模式
- 缺少 viewBox 导致移动端裁切
- 字体缺失造成换行变化
- 文本对比度不足
- 把重要数据只放进图中
风险较高的业务应增加人工复核和独立安全测试。本文不把公开资料整理写成编辑部实测，也不提供无法复现的速度、准确率或收益数字。
常见问题
只要官方示例能运行就可以上线吗？
不可以。官方示例用于说明能力或接口，仍需用你的数据、权限、负载和失败场景验证，并保存可以回放的结果。
为什么必须保留基线？
没有相同输入和相同指标的基线，就无法判断新方案是否真正改善，也无法在故障时确认回滚是否恢复。
版本变化后需要全部重做吗？
至少应重跑与变化范围相关的确定性检查、核心质量集、安全边界和恢复演练；重大模型、框架或数据变更应做完整回归。
下一步与一手来源
可继续阅读：Python 可复现基线、RAG 检索基线、模型评测与回滚。这些内链分别帮助补齐模型路由、对话系统和 Agent 治理边界，不替代本文缺失内容。
一手与原始资料：MDN SVG、MDN SVG 教程、MDN viewBox、MDN WCAG 可感知性指南、Python XML ElementTree。访问与事实复核日期：2026-09-10。
