这个问题我之前帮不少人解决过，核心原因其实是GitHub的预览服务和本地Markdown工具对路径的解析逻辑不一样：

• GitHub能识别../assets/screenshot.png这种跨分支路径，自动跳转到对应分支的根目录读取文件；
• 但本地VS Code、Atom这类工具只会按照当前工作区的文件系统路径查找，而你当前在master分支的工作区里，根本没有../assets这个目录（因为assets分支的内容不在当前工作区），自然加载失败。

下面给你几个实用的解决方案，按需选择：

方法一：用git worktree挂载分支 + 兼容本地/GitHub的图片路径 #

这是我最推荐的方案，既能保持分支分离的结构，又能两边正常显示：

1. 先切换到master分支：

   git checkout master
   

2. 用git worktree把assets分支挂载到当前工作区的assets文件夹：

   git worktree add ./assets assets
   

   执行完后，你的master分支工作区会多出一个assets文件夹，里面就是assets分支的所有内容。
3. 修改README里的图片引用为HTML格式的兼容路径：

   <img src="./assets/screenshot.png" alt="项目截图" onerror="this.src='raw/assets/screenshot.png'">
   

   • 本地预览时，工具会直接读取当前工作区assets文件夹里的图片，正常显示；
   • GitHub预览时，本地路径加载失败会触发onerror，自动切换到GitHub的跨分支raw路径（这里省略了仓库前缀，GitHub会自动补全）。

方法二：同步图片到master分支 #

如果能接受master分支里也存放一份图片文件，这个方法最简单：

1. 在assets分支更新图片后，切换回master分支：

   git checkout master
   

2. 把assets分支的图片文件同步到master：

   git checkout assets -- screenshot.png
   

3. 在master分支创建assets文件夹，把图片移进去，然后提交：

   mkdir -p assets
   mv screenshot.png assets/
   git add assets/screenshot.png
   git commit -m "同步assets分支的截图到master"
   

4. 最后把README里的图片路径改成./assets/screenshot.png，这样本地和GitHub预览都能直接识别。

方法三：使用GitHub Raw URL（适合优先保障GitHub预览的场景） #

如果本地预览需求不高，或者愿意用支持在线URL的Markdown插件，直接用GitHub的raw路径：

![项目截图](https://github.com/你的用户名/你的仓库名/raw/assets/screenshot.png)

本地的话，可以安装VS Code的「Markdown Preview Enhanced」这类插件，它能自动加载GitHub的raw图片（需要联网）。

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