最近好几个朋友都在问我同一个问题：Typora里的图片突然不显示了，有的直接红叉，有的只剩一个空白的占位框，还有的打开一看全是图片路径文字。这个问题的出现频率是真的高，尤其是笔记写了一段时间、文件夹结构调整过、或者从别人的文档里复制内容进来之后。这篇不绕弯子，直接讲清楚Typora图片显示不出来的根因、排查思路和可落地的解决办法。内容会覆盖本地图片、粘贴图片、网络图片、导出场景四大类，适合正被这个问题折磨的Markdown写作用户，也适合打算把Typora当主力笔记工具的新手提前避坑。
1. 问题全景：Typora图片显示不出来的常见表现
1.1 一张图片引发的写作事故
先说我见过最多的场景。一个朋友攒了三个月的技术笔记，目录结构一直是“笔记.md + 笔记.assets/ 图片文件夹”，某天他想把笔记归类到新的项目目录下，直接把整个文件夹拖过去了。再打开Typora，好家伙，正文里的架构图全裂了，截图全空了，连封面图都不见了。
他的第一反应是“图片文件坏了”，赶紧去文件夹里翻了半天，发现图片明明都还在，一个字节都没少。这就是典型的引用断链——图片本身没丢，丢的是笔记文档和图片文件之间的“导航关系”。Typora本质上还是一个Markdown编辑器，它不把图片数据塞进文档里，而是根据文档里写的路径去磁盘上找文件。路径失效，图片自然消失。搞清楚这一点，后面所有排查都有方向了。
1.2 先分清现象，再找根因
很多人一上来就问“图片为什么不显示了”，但“不显示”其实有好几种完全不同的表现，根因和处理方式也不一样。我习惯让朋友先对着下面这个表自查，效率高很多：
| 现象 | 典型原因 | 处理优先级 |
|---|---|---|
图片位置显示一串路径文字，如 | Markdown语法里的路径失效 | 高 |
| 图片区域是空白的占位框 | 图片文件被移动、删除或重命名 | 高 |
| 粘贴的图片当时显示，重启后消失 | 图片存到了临时缓存目录 | 高 |
| 网上的图片加载不出来，转圈或无响应 | 网络受限、图床防盗链 | 中 |
| 导出PDF/Word后图片全没 | 导出时资源没有嵌入或路径失效 | 高 |
| 图片显示一半，另一半灰白 | 图片文件本身损坏或格式支持异常 | 低 |
这个表建议截图保存。绝大多数人遇到的是第一、第二、第五种，本质都是“文档引用和实际文件位置对不上”。只有分清了自己是哪一类，才能用对下面第3章的对应方案。
1.3 花三分钟给文档做个“体检”
在动任何设置之前，我建议先做一个快速体检，判断问题到底出在哪一层。打开Typora右上角的“视图”，能看到当前文档的源码模式（快捷键Ctrl+/）。在源码模式下，图片会以的形式露出真面目。看两个地方：
一是看()里的路径是什么。是https://开头的网络地址，还是assets/、C:\Users\这类的本地路径？二是去文件管理器里手工访问这个路径，看文件是不是真实存在。我见过不少案例，文档里写的是./assets/logo.png，但当前文档所在的文件夹下面根本没有assets这个目录，图片自然不可能显示的。这两步做完，问题基本能定位到“路径错误”“文件缺失”“网络问题”三个方向里的一个。
2. 原理拆解：Typora到底是怎么找到图片的
2.1 Markdown图片引用的底层逻辑
Markdown里插入图片的语法极其简单：
比如：
[]里面是图片显示不出来时展示的替代文字，()里面是图片的真正地址。Typora渲染这个语法时，会拿着()里的路径去磁盘或者网络请求资源，请求到了就渲染，请求不到就给你一个占位框或裂图。可以把这个过程类比成你给朋友发了张照片，但只说了“照片在我家卧室床头柜第二个抽屉里”。朋友到了你家，发现抽屉是空的，或者你家根本不在那个地址，那他自然拿不到照片——这就是“图片显示不出来”的完整逻辑。
2.2 相对路径与绝对路径：一张图说清楚
Typora支持两种本地图片路径写法：相对路径和绝对路径。
绝对路径是从盘符或根目录写起的完整地址，例如：
这种写法有一个致命弱点：只要笔记文档被移动到其他电脑或其他目录，这个路径基本就废了。因为别的电脑上不可能正好也在C:/Users/Zhang/Documents/Notes/下放同一张图。
相对路径是相对于当前文档所在位置的写法，例如：
意思是“在当前文档所在的文件夹下，找到assets文件夹，再找到architecture.png”。只要你把整个笔记文件夹（包括文档和图片文件夹）一起搬走，相对路径依然有效。这也是为什么我强烈建议所有本地笔记都使用相对路径。
打个比方，绝对路径是“去上海市xx区xx路xx号找人”，相对路径是“在这个小区里找3号楼二单元的邻居”。小区换了地方，绝对路径就失效了；但只要人还在同一个小区里，相对路径照样能找到。
2.3 为什么“昨天还好好的，今天就红了”
这是被问得最多的一句话。图片昨天还显示，今天突然全裂了，中间发生了什么呢？常见的导火索就这几类：
- 把
.md文件单独移动了，但没带上同名.assets文件夹 - 给图片所在文件夹改了名，比如从
image改成img - 在网盘同步时，同步工具对路径做了调整或产生了冲突副本
- 用系统清理工具清理了临时目录，Typora的粘贴缓存被清掉
- 同一份文档从Windows换到macOS/Linux上打开，路径分隔符不一致（Windows用
\，macOS和Linux用/）
我印象最深的一次，是我自己把笔记从“写作中”文件夹归档到“已发布”文件夹，嫌原文件名太长，顺手改了笔记md的文件名，结果Typora默认的图片目录${filename}.assets也跟着变了，而老图片还留在旧目录里，结果就是全文图片几乎全灭。从那以后我养成了一个习惯：改md文件名之前，先把图片目录处理好。
3. 分场景实操：按症状对症下药
3.1 场景一：图片位置显示路径文字或裂图
这是最典型的一种。在源码模式下，会看到类似：
而实际上，当前文档所在目录下没有images目录，或者arch.png不在里面。怎么办？两条路：
第一，重建引用。把光标放在图片语法处，打开顶部菜单“格式 → 图像”，或者直接把图片文件从资源管理器拖拽进Typora窗口。Typora会自动生成正确的引用语法，替换掉原来失效的那个。这个操作简单粗暴，但注意它会改变图片在文档中的插入位置，如果原图是嵌在某段文字中间，拖拽后你需要重新排一下位置。
第二，手动修正路径。如果只有一两张图，直接改源码里的路径就行。先确认图片在哪，比如图片在文档所在目录的files/arch.png下面，就把源码改成：
如果图片在上一级目录的shared/images里，那就写成：
../代表“上一级目录”，两层用../../，这是相对路径的基础语法，学一下终身受用。
3.2 场景二：粘贴的图片当时显示，重启后消失
这里涉及Typora的一个关键机制。当你从剪贴板粘贴一张截图时，Typora会把图片数据落盘到某个目录，然后在文档里写入对应引用。如果你没有在偏好设置里指定落盘策略，图片可能会被放到系统的临时目录，例如Windows下的%TEMP%或者macOS的/tmp。系统清理工具一跑，临时目录被清空，图片引用就找不到文件了。
解决办法：给Typora设置固定的图片存储目录。进入“文件 → 偏好设置 → 图像”（macOS在“Typora → 偏好设置”），在“插入图片到当前文档时”那个下拉框，选择“复制到当前文档所在文件夹下的${filename}.assets文件夹”。这样每篇笔记都有自己独立的图片目录，md文件搬到哪里，图片目录就跟到哪里，不会再依赖系统临时位置。
设置之后，对已经出问题的旧图片怎么补救？如果是还在系统临时目录里的文件，先去临时目录把图片找出来，复制到笔记的assets目录，再手动改一下文档里的引用路径。如果临时目录已经被清理，那就只能重新粘贴了——这也是为什么我一直劝大家：粘贴图片后，尽快设置好存储策略，别拖。
3.3 场景三：网络图片加载不出来
有些文档里引用了外链图片，比如：
Typora显示空白，先分两种情况。第一，网络本身无法访问这个地址，这个没啥好说，就是网络问题。第二，图片服务器防盗链——很多图床、博客平台会检查请求来源，如果你的Referer不是它们允许的站点，就会返回403，Typora里自然显示不出来。
对于网络图片，我其实不太建议长期依赖外链。最好的方式是右键图片（在浏览器里能打开的情况下）另存到本地，改成本地相对路径引用。你写的是技术笔记、工作文档，图片的稳定性比什么都重要。某天图床挂了、过期了，你文章里的图就会大片消失，这时候后悔都来不及。我在写长篇文档时给自己定了一条规矩：所有图片最终必须落到本地。网络图片只是临时预览用的。
3.4 场景四：导出PDF/Word后图片丢失
这个场景最容易让人抓狂：Typora编辑器里图片显示得好好的，一导出PDF，图片没了或者只有一张空壳。
先说原因。Typora导出PDF时，如果图片引用是相对路径，导出模块会去相同路径下找图。多数情况下能成功，但如果图片路径里有中文、特殊字符，或者你用的是自定义CSS主题但图片目录匹配有误，就可能出现丢失。还有一个常见坑：文档里混合了本地图片和网络图片，本地图片正常、网络图片没下载下来，导出时网络图片全部变空白。
对策有几个：一是确保编辑阶段所有图片都是正常显示的，有红叉的先修好；二是尽量不要用“导出HTML”后转PDF的方式，容易把相对路径搞乱，直接用Typora的“导出 → PDF”功能；三是如果文档要交付给别人，且对方不一定能看到你本地图片，最好先用“格式 → 图片”把网络图片下载到本地，再导出一次。我帮人处理过的“导出后图片消失”问题里，至少有三分之一其实是网络图片没有嵌入导致的。
4. 配置调优：从源头规避图片问题
4.1 图片存储策略：统一比聪明更重要
处理图片问题，最高级的姿势不是出了问题再修，而是从配置层面杜绝问题。我这里推荐一套我用了很久的方案，适合大多数个人笔记场景：
- 每篇笔记单独一个文件夹，文件夹内放
md文件和同名.assets图片目录 - 所有图片引用统一使用相对路径
- 网络图片一律下载到本地再引用
- 不要再多个笔记共用同一个图片目录（比如所有笔记都用
D:/imgs这种），因为一旦消息传到别的电脑或别的平台，路径就断了
这套方案的价值在于“自包含”——每个笔记文件夹拎起来就是完整的，携带、归档、发送都可以。Typora偏好设置里，把“插入图片时”选为“复制到当前文档所在文件夹下的${filename}.assets文件夹”，并且勾选“对本地图片应用以上规则”“对网络图片应用以上规则”和“优先使用相对路径”。勾选了后面两个，Typora在插入本地图片时会自动复制一份到笔记目录，网络图片也会自动下载到本地，从根上断了外链依赖。
4.2 别碰这些容易踩坑的“省事”设置
有几种配置看起来省事，实际上隐患很大，我建议避开。
把所有图片放到全局某个固定目录。比如统一存到D:/TyporaImages。在你自己电脑上确实能用，但一旦换电脑、换系统，或把文档发给别人，图片全部失效。除非你只是在自己电脑上写完就删，否则慎用。
使用“上传图片”作为默认插入方式。如果你没有配置好图床，Typora需要借助其他工具才能上传。配置弄不好，粘贴图片时要么卡住，要么上传后返回的地址不对，反而制造了新问题。个人本地笔记，老老实实走本地存储就可以了。
随意改动Typora工作目录或主题缓存目录。有些用户为了“清理空间”，把Typora的一些支持目录手动清理掉，结果容易连带清掉粘贴缓存、主题图片等。这个我之前在排查“图片全部变裂图”时遇到过好几次，罪魁祸首往往是清理工具而不是Typora本身。
4.3 改名、搬家前的标准动作
笔记文件改名或者整个目录搬家，是图片问题的最高发时刻。分享一下我的标准流程：
- 在Typora内关闭该笔记文件
- 在文件管理器中，先把
.md文件和同名.assets文件放在同一个文件夹里 - 如果是整体目录搬家，整个文件夹一起移动，不要只拖动
.md单独走 - 如果只想改md文件名，先把
.assets目录重命名为新文件名对应的新文件名.assets，再改md文件名 - 用Typora重新打开，逐个滚动检查图片
这个顺序极其重要。因为Typora默认的粘贴图片目录是${filename}.assets，你改了md文件名，但图片目录还是旧的，文档里已经被写进去的引用路径就全找不到了。先同步改名图片目录，再改文档名，可以避免大多数重复劳动。
5. 高频问题速查与经验分享
5.1 问题排查速查表
把上面提到的排查思路汇总成一张速查表，收藏下来能省很多事：
| 检查项 | 操作 | 判断标准 |
|---|---|---|
| 查看源码引用 | Ctrl+/切换源码模式，看里的路径 | 确认是本地还是网络路径 |
| 验证文件存在 | 按路径去文件管理器找文件 | 存在/不存在一目了然 |
| 检查图片目录 | 看文档同目录下有没有.assets文件夹 | 目录名是否和文档名一致 |
| 检查相对路径深度 | 确认../数量是否正确 | 层级偏差会直接裂图 |
| 检查文件名 | 中文、空格、大小写是否是导致异常的因素 | 尽量统一用英文小写+连字符 |
| 检查导出设置 | 导出PDF前预览一下 | 所有图片应正常显示 |
5.2 几个容易被忽略的细节
Windows路径反斜杠问题。如果你在Windows上手动把图片路径写成assets\arch.png，在Typora里一般能识别，但当你把文件同步到macOS/Linux，或者用Git等工具时，反斜杠就可能引发问题。Markdown里的本地路径，统一用正斜杠/，这个习惯我踩了两次坑才改过来。
文件名大小写。在Windows上，Arch.png和arch.png没区别，但在Linux服务器上、在一些严格的同步工具里，它们是两个文件。如果文档引用的是小写arch.png，实际文件却是Arch.png，Linux下就显示不出来。所以图片文件名最好统一小写，避免混用。
图片文件被其他程序占用。个别情况下，图片文件被看图软件、网盘客户端锁定，Typora读取不了，也会显示空白。关掉相关软件再试一次，问题可能就消失了。这个概率不高，但排查到这一步时值得留意。
Typora升级后渲染异常。有用户升级版本后出现过图片显示异常的问题。一般等官方修复或者手动重启应用就能缓解。这种情况随机性较强，不建议急着重装，先按本文前面几章排查。
5.3 我常用的两个“保底操作”
最后分享两个我自己救场的经验。
一个是批量重设图片路径。当文档里的图片引用大面积失效，手动改太痛苦时，我的做法是：先把笔记文件夹里的图片目录整理好，再确保所有图片文件命名规整，最后用文本编辑器（比如VS Code）打开md文件，用全局替换功能把旧的错误路径统一替换成新路径。比如旧路径是img/开头，实际图片在assets/下，就全局把](img/替换为](assets/。一次搞定，省时省力。
另一个是**“拖回去”法**。如果一张图片的原文件已经彻底找不到了，但你还记得它长什么样，可以在任意截图软件里重新截一张，或者去浏览器的历史记录里找到原图下载回来。然后在Typora里直接把图片文件拖到原先的位置，Typora会自动写入正确的引用并替换裂图。这个操作听起来土，但实际救回过我不少历史文档里断链的文章配图。
Typora图片显示问题，说到底是路径管理问题。只要你在写作初期就养成“图片跟随文档”“统一使用相对路径”“网络图片落地本地”三个习惯，这类问题基本都不会找上你。如果已经出了问题，也别急，按上面的顺序层层排查，大多数情况十分钟内都能修好。
