企业官网建设流程全解析

你有没有过这种经历：在Typora里写文档，顺手截图、Ctrl+V粘贴，当时一切正常，等过两天把md文件拷到另一台电脑或者发给同事，整个文档里的图片全部变成“破图”图标。更麻烦的是，你在本地翻来覆去也找不到那些图片到底存在哪。这个问题十个人里九个会遇到，根子就在Typora对图片复制粘贴的默认路径处理上：粘贴进来的图片被写进了系统临时缓存目录，md文件里记录的则是一条绝对路径。文件一旦离开当前机器，路径失效，图片自然跟着失踪。这篇不说别的，专门把Typora的图片路径逻辑一次讲透，让图片复制粘贴之后能真正“一步到位、跟着文件走”。

1. 粘贴的图片为什么总在某个你找不到的“临时目录”里？

先说一个反直觉的事实：你在Typora里按下Ctrl+V的那一刻，图片并不是存放在你正在编辑的md文件旁边，而是先被Typora写进了它的图片缓存目录。这个目录在Windows上通常长这样：

C:\Users\你的用户名\AppData\Roaming\Typora\ImageCache

在 macOS 上则位于：

~/Library/Application Support/Typora/ImageCache

Typora会把这个临时目录里的文件用一串随机字符命名，比如image-20240115-xxxxx.png，然后在你的Markdown源码里插入类似这样的引用：

![截图](C:/Users/你的用户名/AppData/Roaming/Typora/ImageCache/image-20240115-xxxxx.png)

这种引用方式在你自己电脑上没有任何问题，因为文件路径真实存在。但只要md文件被移动、被压缩发送、被传到另一台电脑，图片的绝对路径就失效了。甚至哪怕你只是把md文件从文件夹A挪到文件夹B，那条指向C盘Roaming目录的路径也会断。遇到这种情况，网上的搜索词往往集中在“Typora导出没有图片”“Typora导出Word没图片”这类结果上，实际上大多也是同一个病根：路径根本不是相对路径，或者资源文件夹没有跟着md一起移动。

1.1 先确认你的图片到底被写进了哪里

判断方法很简单。打开Typora，找到一张刚粘贴的图片，点击图片后在菜单栏执行“编辑 → 图片 → 编辑图片”或直接右键图片查看属性，你会发现它的路径要么指向ImageCache，要么是一长串绝对路径。更直接的方法是切到源码模式：在Typora中按Ctrl+/或者点击左下角源码模式图标，查看对应图片标签里的括号。

比如说你看到的是：

![](C:/Users/admin/Pictures/Screenshots/xxx.png)

或是

![](C:/Users/admin/AppData/Roaming/Typora/ImageCache/figure-001.png)

这些全是危险信号。前者是本地固定位置，换台电脑就没了；后者依赖缓存目录，Typora一旦清理缓存，图片也会一起蒸发。

1.2 绝对路径和相对路径，为什么只有相对路径可以“带走”

这里需要把两个概念说透。绝对路径是从盘符或根目录开始的完整路径，比如C:/Users/admin/Desktop/note.md，它只对你的这一台电脑有效。相对路径则是相对于当前md文件所在位置的一条“寻路线索”，比如./note.assets/xxx.png，意思是“当前目录下的note.assets文件夹里的xxx.png”。只要md文件连同它旁边的assets文件夹一起移动，相对路径在任何电脑上都能继续生效。

可以拿住址来类比：绝对路径是“中国北京市朝阳区某街道某号”，相对路径则是“邻居家门口往右数第三间房”。你搬到另一个城市，前者就失效了，后者只要邻居还在，依然能找到当时的房间。所以让图片跟着文件走，本质上就是把图片从系统各个角落拉回md文件身边，并在md里使用相对路径。

2. 三处偏好设置同时勾上，新粘贴的图片才会自动进“贴身文件夹”

理解了原理之后，设置其实只有几步。很多教程都提过“偏好设置-图像”里要改选项，但不少人只改了其中一项，结果图片还是跑偏。真正生效需要三个开关都到位。

2.1 打开偏好设置-图像这一页

在Typora里点击菜单栏：

• Windows / Linux：文件 → 偏好设置
• macOS：Typora → 偏好设置

在弹出的设置窗口里找到“图像”选项卡。这页管着所有插入图片时的默认行为。下方常驻的“优选相对路径”“对网络图片应用以上规则”“对本地位置的图片应用以上规则”这几个复选框，就是决定路径风格的关键。

2.2 “复制图片到”的三种方案怎么选

在“图像”选项卡顶部，有一个下拉选项叫“插入图片时”，它一般提供以下选择：

我个人的习惯是选复制图片到 ./${filename}.assets 文件夹。这个方案的优势在于：每个Markdown文件自成一个“文件+同名资源文件夹”的单元，移动、压缩、发给别人都特别干净。比如你有一篇月报.md，Typora会自动创建月报.assets文件夹，粘贴的图片全部塞在里面，md里的引用则变成：

![](月报.assets/image-0001.png)

文件和文件夹放在一起搬走就行，彻底脱离系统缓存目录。./${filename}中的${filename}代表当前md文件的主文件名，注意不包含.md后缀。比如复盘.md对应的文件夹就是复盘.assets。

2.3 别忽略“对本地位置图片应用以上规则”和“优先使用相对路径”

这一步是最容易被跳过的。你光选了“复制图片到 ./${filename}.assets 文件夹”还不够，如果下面几个复选框没有勾上，Typora在处理某些来源的图片时还是会走旧逻辑。

具体来说：

• “对网络图片应用以上规则”：当你从浏览器直接拖拽或复制一张网络图片进Typora时，如果勾了这项，Typora会把网络图下载到本地assets文件夹，而不是直接引用外链。好处是文档离线可看，坏处是网络图下载不成功时会变为空白。我个人建议按需开启，如果你经常采集网页资料，开着更安心。
• “对本地位置的图片应用以上规则”：当你把电脑上已有的图片拖进Typora时，如果勾了这项，Typora会把它复制一份到assets文件夹，而不是保留原绝对路径。这个开关非常重要，不勾的话你从桌面拖一张图进md，最终引用的还是C:/Users/.../Desktop/xxx.png，换台电脑照样断链。
• “优先使用相对路径”：这一项决定了写入md文件里的引用风格。勾选之后，Typora会尽量使用相对路径，比如./月报.assets/image.png，而不是绝对路径C:/.../月报.assets/image.png。如果不勾，即使图片已经复制到assets文件夹，md里的引用也可能仍是绝对路径，移动到别的目录一样会出问题。

很多人以为只要选了“复制图片到 ./${filename}.assets 文件夹”就万事大吉，结果图片确实被复制了，但md里引用的还是绝对路径，移到别处依然看不到图。我建议把“对本地位置的图片应用以上规则”和“优先使用相对路径”都勾上，然后再拿一张新图测试一遍，切到源码模式确认引用是相对路径，才算真正配置完成。

3. “跟随文件”不等于随便放，命名规则直接决定之后整理文档时的心情

把设置改完之后，接下来的问题是：文件夹命名规则到底选哪种更舒服。不同场景差异很大，选错后期整理资料会相当痛苦。

3.1${filename}.assets和统一assets文件夹的区别

我们实际来看两种规则落地的差异。

假设你在D:/docs目录下写了三篇文档：

D:/docs ├── 月度报告.md ├── 季度规划.md └── 周报.md

如果选“复制图片到 ./${filename}.assets 文件夹”，目录结构会变成这样：

D:/docs ├── 月度报告.md ├── 月度报告.assets │ └── image-01.png ├── 季度规划.md ├── 季度规划.assets │ └── image-01.png ├── 周报.md └── 周报.assets └── image-01.png

每篇文档都有自己独立的资源文件夹，即使三篇文章里的图片都叫image-01.png，也不会冲突。分发时，每个人只需要带走月度报告.md和月度报告.assets这两个东西，不会误带别人的图片。

如果选“复制图片到 ./assets 文件夹”，目录则会这样：

D:/docs ├── assets │ ├── image-01.png │ ├── image-02.png │ └── image-03.png ├── 月度报告.md ├── 季度规划.md └── 周报.md

所有图片堆在同一个assets目录下，好处是如果你要把这个目录整体发到某个静态服务器，目录结构简单清爽；坏处是文档多了以后，你根本分辨不出某张图属于哪篇文章。当项目积累到几十篇md、上百张图片时，清理孤儿图片会变成一场灾难。

3.2 Typora的${filename}变量到底适合哪些场景

${filename}变量在实际使用中，最合适的是“一篇文档一个完整内容包”的场景。比如我写课程讲义、项目复盘、个人技术博客，基本都是这个结构。因为这类文档经常需要被单独打包发出去，或者被从本地搬运到公司内网，资源文件夹跟着文档走最省心。

反过来说，如果你维护一个静态博客仓库，所有文章共用一套图片资源，或者网站框架强制要求图片统一存放在images/目录，那不用纠结，直接选“复制图片到 ./assets 文件夹”或“自定义文件夹 ./images”就对了。Typora允许你填绝对路径或相对路径，其中相对路径会基于当前md文件所在的文件夹来解析。如果你填../images，表示图片放在当前md文件上一级目录的images文件夹里。这种用法适合统一管理大量共享素材的场景。

我自己还遇到过一种特殊需求：用Typora写书稿，整本书里有上百个md章节，每一章一张配图，最后需要交给排版同事。这时候如果每一章都生成一个章节.assets文件夹，排版同事会疯掉。于是我选择了自定义文件夹./figures，所有章节的图都落到书稿根目录的figures下，统一按章节前缀命名，比如chapter01.png、chapter02.png。这样排版流程只需要引用一个固定的相对路径就够了。

所以结论很直接：没有绝对最优的命名规则，只有最适合你内容生产方式的规则。对大多数个人笔记和知识管理场景来说，${filename}.assets是容错率最高的选择；对站点或出版物场景，统一目录往往更实用。

3.3 手动指定路径时，正斜杠和反斜杠的隐患

Windows用户经常会在自定义路径时习惯性输入反斜杠\，比如.\images\logo.png。Typora在Windows上能识别，但这篇md一旦同步到Mac或者推送到GitHub，反斜杠就会被识别成普通字符或者转义符，图片路径直接失效。最稳妥的做法是统一使用正斜杠/，比如./images/logo.png。别小看这个细节，我自己在同步到Git仓库时踩过无数次坑，最终把所有路径都改成正斜杠，问题才彻底消失。

4. 老文档的图片搬运：别一张张重贴，用迁移和批量脚本搞定

配置完成后，只对新粘贴的图片生效。已经写好的文档如果还引用着旧路径，需要做一次图片搬家。这里分两种情况：文档数量少时，让Typora自己从头处理；文档数量多时，直接上脚本批量改。

4.1 少量文件：让Typora自己重新插入图片

假如一篇文章里只有几张图片，最省事的办法是把图片从旧位置拖进md文件里，触发Typora的自动复制逻辑。操作步骤是：

1. 先确认偏好设置里的规则已经按要求配好。
2. 打开md文件，切到普通模式。
3. 在文件资源管理器中找到图片所在位置，把图片直接拖进Typora窗口中。
4. Typora会按你设置的规则把图片复制到当前md的assets文件夹，并写一条相对路径引用。

对于分散在各处的图片，可以先把它们全部整理到一个临时目录，再逐张拖进Typora。注意别拖成重复插入，插入后如果图片没有自动复制，重启Typora再试一次。部分版本的Typora对于拖入的本地图片，默认会保留原路径，这时候就需要手动在“偏好设置-图像”里确认“对本地位置的图片应用以上规则”是勾选状态。

还有一种更快捷的小技巧：直接把图片复制到md文件旁边，然后在md源码模式里手工把路径改成相对路径。只要assets文件夹就在md同级目录，路径写成./xxx.assets/图片名.png就能生效。但这种方法只适合图片数量少的情况，一多就容易漏。

4.2 批量做法：用Python脚本把绝对路径改成相对路径

当历史文档有几十篇、图片分布在各处时，手工拖拽会拖到怀疑人生。这时候建议用一个批量迁移脚本：扫描目录下所有md文件，把所有非网络图片的引用路径解析出来，把图片复制到对应md文件的xxx.assets目录下，同时把md里的引用改写成相对路径。

下面是我自己常用的一个参考脚本，基于Python 3运行：

import re import shutil from pathlib import Path def fix_md_images(md_path: Path) -> None: text = md_path.read_text(encoding="utf-8") target_dir = md_path.with_name(md_path.stem + ".assets") md_parent = md_path.resolve().parent pattern = re.compile(r"!\[([^\]]*)\]\(([^)]+)\)") changed = [] for match in pattern.finditer(text): alt_text, src_raw = match.group(1), match.group(2) # 跳过网络图片 if src_raw.startswith(("http://", "https://")): continue src = Path(src_raw) if not src.is_absolute(): src = (md_parent / src_raw).resolve() else: src = src.resolve() # 如果图片已经在目标目录里，跳过 if src.parent == target_dir.resolve(): continue if not src.exists(): print(f"[缺失] {src} 在 {md_path.name} 中引用，无法自动迁移") continue target_dir.mkdir(exist_ok=True) dest = target_dir / src.name # 如果同名文件已存在，可以加序号避免覆盖 if dest.exists(): dest = target_dir / f"{dest.stem}_{len(changed)}{dest.suffix}" shutil.copy2(src, dest) new_ref = dest.relative_to(md_parent).as_posix() changed.append((src_raw, new_ref)) text = text.replace(match.group(0), f"![{alt_text}]({new_ref})") if changed: md_path.write_text(text, encoding="utf-8") for old, new in changed: print(f"{md_path.name}: {old} -> {new}") if __name__ == "__main__": root = Path(r"D:/docs") # 改成你的md目录 for md in root.rglob("*.md"): fix_md_images(md)

这段脚本的读取逻辑比较朴素，但它能处理绝大多数标准Markdown图片引用。运行前建议先复制一份目录备份，避免误改。如果你在图片括号里使用了带空格的文件名，正则可能需要微调，比如改成匹配[^)]*到最后右括号即可，基本够用。

批量脚本跑完后，用Typora打开几篇md抽查，确认图片显示正常，再进入下一步：把整个目录连同所有assets文件夹一起同步或压缩。

5. 设置完成后，导出PDF/Word、云同步、Git协作的实际收益和坑

图片真正“跟着文件走”之后，影响的远不止本机查看体验。导出格式、云同步、团队协作，几乎每个环节都会受益，但同时也潜伏着一些值得注意的坑。

5.1 “导出没有图片”最常见的病根，就是路径已经断了

你搜“Typora导出没有图片”，会发现大量案例的共同特征：md文件里引用的是绝对路径或ImageCache路径。Typora导出PDF、Word、HTML时，本质上是在内存里渲染文档，再调用导出引擎。如果图片路径解析不到，导出结果里就会留下一个空白占位符。解决思路很明确，不要等到导出时才处理，而是在写文档时就让所有图片都处于md文件旁边的assets文件夹中，并且引用是相对路径。

做了这一步之后，导出PDF和Word时图片基本不会再丢失。如果某一天你发现某个文档里个别图片在导出时消失，第一反应应该是去源码模式看图片路径是否出现C:/或AppData字样。出现就说明图片还没迁移干净，再用第4章的方法处理那几张图就完事了。

5.2 跨平台和云同步时，斜杠、大小写和冲突文件都是暗坑

图片跟着文件走后，跨平台同步虽然比之前稳得多，但有几个细节值得关注。

第一，路径分隔符。Windows资源管理器显示的是反斜杠\，但Markdown里推荐写成正斜杠/。你把路径写对之后，Typora在Windows上能正常显示，到了macOS、Linux以及GitHub Web端，也能正常解析。如果引用了反斜杠，Git仓库和Mac上大概率会挂。

第二，文件大小写。macOS和Linux对文件名字母大小写敏感，Windows不敏感。比如你在Windows上写了Assets/Image.png，实际文件夹叫assets，同步到Mac上就可能失效。因此，建议所有assets文件夹和图片名保持统一的小写风格，至少在新建文件时就约定好。

第三，云同步冲突文件。我用的同步盘同步较多，如果两个设备同时修改同一个assets文件夹里的图片，某些网盘会在目录里生成“XXXX-冲突文件-XXXX.png”，md引用的原图片名不会变化，于是图片也会一起丢。这是个冷门坑，但你遇到了就知道痛了。随身同步建议别同时在多台设备编辑同一篇带图文档，或者至少把同步间隔设短一点。

5.3 我最终稳定下来的工作流

折腾过各种方案之后，我现在的工作流非常固定：所有md文档全部放在一个仓库目录下，Typora图片副本策略设置成复制图片到 ./${filename}.assets 文件夹，勾选“对本地位置的图片应用以上规则”，勾选“优先使用相对路径”。写文档时，截图或拖图进去的位置不必太在意，Typora会自动把资源归拢到对应的assets文件夹里。每次写完一篇，我只需要把md文件和旁边同名assets文件夹一起提交到Git仓库或压缩发送。

如果碰到一些旧文档是从别处复制来的，里面带了一堆外链图片，我会先决定是否要本地化。个人知识库我一般全部本地化，这样离线也能看；如果是发给别人且明确允许引用网络图，就保留原外链。判断标准很简单：你想让这份文档在三个月后、换一台电脑时打开还能完整显示吗？需要的话，就让它跟着文件走。

这里还有一个很少人注意的小技巧：当你把md文件从笔记目录拖到另一个项目目录时，记得连同assets文件夹一起拖。Typora不会自动帮你从原assets文件夹把图片带到新位置，很多人在这一步又把图片弄丢了。把文件夹做成一个整体来管理，这是“图片跟着文件走”的最后一道保险。