如何解决turtle绘图保存为图片/SVG文件打开显示白屏的问题

核心原因 #

绝大多数这类问题都是两个原因导致的：

1. 所有绘图操作都在原生turtle.Turtle实例上执行，SvgTurtle实例没有收到任何绘图指令，最后保存的自然是没有内容的空文件
2. 绘制完成后没有正确触发SvgTurtle的保存逻辑，或是图形坐标超出了SVG画布的视口范围，内容没有被渲染到可视区域

分步解决 #

• 先替换绘图实例
  SvgTurtle完全兼容原生Turtle的接口，所有绘图动作（画圆、抬笔落笔、改颜色、移动坐标等）都要在SvgTurtle初始化的实例上执行。如果把绘制逻辑写在原生Turtle()生成的对象上，内容只会画在turtle弹出的tkinter窗口里，不会写入SVG文件。
  错误写法参考（会导出空SVG）：

  # 错误：用原生Turtle绘图
  tur = Turtle()
  tur.circle(100)
  # 最后保存的svg里没有任何路径内容
  

  正确的基础代码框架：

  from svg_turtle import SvgTurtle
  from random import randint
  
  # 先定义SVG画布尺寸，根据你的绘图范围调整
  WIDTH, HEIGHT = 800, 600
  # 初始化SvgTurtle实例，后续所有绘图都用这个对象
  t = SvgTurtle(WIDTH, HEIGHT)
  
  # 下方写你的圆形绘制逻辑即可，接口和原生Turtle完全一致
  t.penup()
  # 注意圆形绘制的起始坐标不要超出画布范围，不然会显示空白
  t.goto(0, -100)
  t.pendown()
  # 随机颜色示例
  t.pencolor(randint(0,255)/255, randint(0,255)/255, randint(0,255)/255)
  t.circle(100)
  
  # 关键：所有绘制完成后再调用save方法写入文件，不要提前调用
  t.save("circle_output.svg")
  

• 如果需要同时保留turtle弹窗预览功能，要保证原生Turtle实例和SvgTurtle实例的绘图动作完全同步，不要只给其中一个实例发绘图指令；另外不要提前调用Screen().exitonclick()，该方法会提前销毁画布资源，导致SvgTurtle无法读取已绘制的内容。
• 排查SVG是否真的写入内容：右键查看导出的SVG文件大小，如果文件大小只有几百字节，说明没有写入任何图形路径，回到第一步检查绘图实例是否用错；如果文件大小在几KB以上但打开还是空白，检查你绘制的图形坐标是否超出了设置的画布范围，把图形移到画布视口内、或调大画布尺寸即可。
• 转JPG/JPEG白屏的问题本质是空SVG导致的，只要SVG导出正常，转码就不会出错。推荐用cairosvg配合PIL做格式转换，避免转码兼容问题：
  1. 先安装依赖：pip install cairosvg pillow
  2. 在SVG保存完成后追加以下代码即可导出JPG：

  import cairosvg
  from PIL import Image
  # 先转成png格式做中转
  cairosvg.svg2png(url="circle_output.svg", write_to="temp.png")
  # 转成RGB格式去掉透明通道后保存为jpg
  Image.open("temp.png").convert("RGB").save("circle_output.jpg", quality=95)
  

内容的提问来源于stack exchange，提问作者user19438162