Typora图床配置完全指南：三种主流方案对比与实操
Typora作为广受欢迎的Markdown编辑器，写作体验一流，但图片管理一直是用户的痛点。本地图片无法跨设备同步、分享文档时图片丢失、博客发布后图裂——这些问题的根源都指向同一个解决方案：配置图床。本文围绕Typora图床配置，对比PicGo、uPic、自定义脚本三种主流方案在Windows、macOS及移动端的表现差异，给出可直接复用的配置参数与故障排查步骤，帮助你一次配通、长期省心。
为什么Typora需要配置图床
用Typora写过文章的人大概都遇到过这个场景：本地写好一篇图文并茂的文档，发给同事或上传到博客平台后，图片全部显示为裂图。原因很简单——Typora默认将图片保存在本地路径，路径一变，图片就找不到了。
图床的作用是把图片上传到云端服务器，返回一个公网可访问的URL。Typora从1.0版本开始正式支持"图片上传服务"功能（偏好设置 → 图像），可以在粘贴或拖入图片的瞬间自动完成上传并替换链接。这意味着你的Markdown文件里不再有本地路径，只有稳定的网络地址，无论在哪台设备打开都能正常显示。
配置图床还有一个容易被忽视的好处：文档体积大幅缩小。一篇包含20张截图的教程，本地存储可能超过50MB，换成图床链接后Markdown文件本身只有几KB，Git仓库管理和版本对比都会轻松很多。
三种主流Typora图床配置方案对比
Typora官方支持的上传方式主要有三类，适用场景各有侧重。
PicGo（推荐指数最高）。PicGo分为桌面版（PicGo App，当前稳定版v2.3.1）和命令行版（PicGo-Core）。桌面版有GUI界面，配置直观，支持GitHub、阿里云OSS、腾讯云COS、七牛、又拍云、S3兼容存储等十余种图床，Windows和macOS均可使用。在Typora中的配置路径为：偏好设置 → 图像 → 上传服务 → 选择"PicGo(app)"或"PicGo-Core" → 填入PicGo的安装路径。配置完成后点击"验证图片上传选项"按钮，Typora会上传一张测试图并返回URL，成功即表示链路打通。
uPic（macOS专属）。如果你是Mac用户且偏好轻量工具，uPic是不错的选择。它是原生Swift开发的macOS应用，资源占用极低，支持通过Homebrew安装（`brew install --cask upic`）。Typora中选择上传服务为"uPic"即可，无需额外填写路径。uPic同样支持主流云存储，配置界面比PicGo更简洁，但缺点是没有Windows版本。
自定义命令（Custom Command）。对于有特殊需求的用户——比如要上传到自建MinIO服务器或需要对图片做压缩预处理——Typora允许填入任意可执行命令。只要这个命令接收文件路径作为参数、输出URL到stdout，Typora就能识别。典型写法如：`node /path/to/upload.js`，脚本内部调用云存储SDK完成上传并`console.log(url)`。这种方式灵活度最高，但需要一定的编程基础。
横向对比：Windows用户首选PicGo桌面版，macOS用户可在PicGo和uPic之间按喜好选择，有定制需求的开发者适合自定义命令方案。
实操：以PicGo + GitHub图床为例的完整配置
这里给出一套零成本、可长期使用的配置方案，全程约10分钟。
第一步，创建GitHub仓库。新建一个公开仓库（如`my-image-bed`），专门用于存放图片。
第二步，生成Personal Access Token。进入GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)，勾选`repo`权限，生成token并妥善保存（页面关闭后无法再次查看）。
第三步，配置PicGo。打开PicGo，进入"图床设置 → GitHub"，填写以下参数：
``` 仓库名：你的用户名/my-image-bed 分支名：main Token：粘贴上一步生成的token 存储路径：img/（可选，建议设置以便归类） 自定义域名：https://cdn.jsdelivr.net/gh/你的用户名/my-image-bed@main ```
自定义域名这一行是关键——直接使用GitHub raw地址在国内访问很慢，通过jsDelivr CDN加速后体验明显改善。
第四步，关联Typora。偏好设置 → 图像 → 插入图片时选择"上传图片" → 上传服务选"PicGo(app)" → 填入PicGo的可执行文件路径（Windows通常为`C:\Users\用户名\AppData\Local\Programs\PicGo\PicGo.exe`，macOS为`/Applications/PicGo.app/Contents/MacOS/PicGo`）。点击"验证图片上传选项"，看到返回的URL即配置成功。
常见故障排查与移动端替代方案
故障一：验证上传时报"Failed to fetch"。最常见的原因是PicGo没有启动，或者端口被占用。PicGo默认监听36677端口，检查方法：在终端执行`curl http://127.0.0.1:36677/api/upload`，如果返回JSON说明服务正常，如果连接拒绝则需要打开PicGo并确认"PicGo-Server"已开启（PicGo设置 → Server → 确认端口为36677且开关打开）。
故障二：上传成功但图片在文档中不显示。检查返回的URL是否能在浏览器中直接打开。如果使用了jsDelivr加速且刚上传，CDN可能有几分钟缓存延迟。另一个常见原因是仓库设为了Private，GitHub私有仓库的图片无法通过公网URL访问，务必确认仓库为Public。
移动端方面，Typora目前没有官方的Android和iOS版本。在移动设备上编辑Markdown并需要图床支持时，可以考虑以下替代组合：iOS上使用Taio或MWeb，它们内置图床上传功能；Android上使用Markor搭配第三方图床工具（如ShareX的移动替代品）。如果你的图床已经配好，这些工具可以复用同一个云存储仓库，保持图片链接体系统一。
总结
Typora图床配置的核心就是打通"粘贴图片 → 自动上传 → 替换为网络链接"这条链路。Windows用户用PicGo桌面版最省心，macOS用户多了uPic这个轻量选项，有定制需求就走自定义命令。GitHub + jsDelivr的免费方案足以应对个人写作和技术博客场景，商业项目则建议选择阿里云OSS或腾讯云COS以获得更稳定的SLA保障。
如果你还没有安装Typora，可以前往官网 typora.io 下载最新版本，配合本文的配置步骤，十分钟内就能告别裂图困扰。已经在用Typora的朋友，现在就打开偏好设置试试吧——配好图床之后的写作体验，是真的回不去了。