VS Code中reStructuredText(.rst)文件HTML预览图片无法显示问题

这个问题是VS Code的reStructuredText扩展在Windows环境下的路径解析规则差异导致的，你之前使用的Windows反斜杠路径会被渲染器识别为转义字符，类UNIX的/c/开头路径是终端适配格式，不符合标准路径解析规则，可按以下方案逐一排查解决：

• 优先使用相对路径（最稳妥跨平台方案）
  把需要引用的图片放在和rst文件同级目录或子目录下，直接写相对于rst文件的路径即可，示例：

  # 图片和rst文件同目录
  .. image:: ./Step-Functions-page1.png
  # 图片放在同目录的img子文件夹下
  .. image:: ./img/Step-Functions-page1.png
  

• 必须使用绝对路径时，需转换为File URI格式
  需要改成带file:///前缀、正斜杠分隔的标准格式，你提供的路径修改后如下：

  .. image:: file:///C:/Users/andreas.luckert/Downloads/Step-Functions-page1.png
  .. image:: file:///C:/Users/andreas.luckert/Downloads/Step-Functions-page2.png
  

• 检查扩展配置项
  打开VS Code设置，搜索restructuredtext.preview.resolveImagePaths，确保该选项处于开启状态，保证预览时会自动解析相对/绝对路径的图片资源。
• 额外注意事项
  路径中如果包含空格、中文或其他特殊字符，需要先做URL编码，比如空格替换为%20，避免解析失败。

内容的提问来源于stack exchange，提问作者Andreas L.