typora图片自动上传需配置图床工具：一、picgo+sm.ms（免注册，token验证）；二、picgo+gitee（私有可控，需插件与令牌）；三、upic+自定义api（macos专属，适配cos等）；四、typora内置gitee上传器（v1.0+，无需第三方）。

如果您在Typora中插入图片后发现仅以本地路径形式保存，导致文档迁移或协作时图片无法显示，则说明图片未配置自动上传功能。以下是实现Typora图片自动上传的多种配置方法：

一、使用PicGo + SM.MS图床配置

SM.MS是免注册、免Token即可快速启用的公共图床，适合轻量级使用，上传响应快且无需额外服务部署。

1、访问sm.ms官网，点击右上角“Login”进入登录页，选择“Sign up”注册账号（无需手机验证）。

2、登录后进入Dashboard页面，点击左侧菜单栏的“API Token”，点击“Generate Token”生成专属令牌。

3、复制生成的API Token，暂存至记事本或微信等临时位置。

4、下载并安装PicGo桌面客户端（推荐v2.3.0+版本），地址：https://www.php.cn/link/8937d22ef4bb674f0aa0e41e7510c880。

5、启动PicGo，在“图床设置”中选择“SM.MS”，将第3步复制的Token粘贴至对应输入框，点击“确定”保存。

6、打开Typora，点击“文件 → 偏好设置 → 图像”，在“插入图片时设置”中勾选“上传图片”，在“上传服务器设置”中选择“PicGo（需已运行）”，点击“验证图片上传选项”测试连通性。

7、验证成功后，即可通过快捷键Ctrl+Shift+I插入本地图片，或直接Ctrl+V粘贴截图，图片将自动上传并替换为在线URL。

二、使用PicGo + Gitee私有图床配置

Gitee图床具备完全可控性与长期稳定性，适合对图片版权、访问权限及域名定制有要求的用户，需配合私人令牌与插件使用。

1、登录Gitee账号，新建一个公开仓库，仓库名建议设为img或typora-images，避免特殊字符。

2、进入Gitee个人设置 → “私人令牌”，点击“生成新令牌”，填写描述如“typora-upload”，勾选repo权限，提交后立即复制生成的令牌值。

3、在PicGo中安装插件：打开“插件设置”，搜索并安装gitee-uploader插件。

4、重启PicGo，在“图床设置”中新增Gitee图床，填写以下字段：
  repo：用户名/仓库名（如zhangsan/img）；
  token：第2步复制的令牌；
  branch：master（或main，依仓库默认分支而定）；
  path：img/（可选，用于统一存放子目录）。

5、在Typora偏好设置 → 图像 → 上传服务器设置中选择“PicGo（需已运行）”，点击“验证图片上传选项”确认上传路径返回有效URL。

6、验证通过后，所有插入或粘贴的图片将自动提交至Gitee仓库，并生成形如https://gitee.com/zhangsan/img/raw/master/img/xxx.png的直链。

三、使用uPic + 自建或第三方API图床配置

uPic适用于macOS用户，支持高度自定义上传逻辑，兼容各类RESTful图床接口（如腾讯云COS、又拍云、自建MinIO等），适合进阶技术用户。

1、前往uPic GitHub Releases页面下载最新版安装包：https://www.php.cn/link/9082eaa58d8b1028c26c256c6de14aab，安装后拖入“应用程序”文件夹。

2、启动uPic，点击菜单栏图标 → “偏好设置”，点击左下角“+”号 → 选择“自定义”。

3、在“上传资源所需配置”中填写：
  上传URL：图床API接口地址（如https://api.sm.ms/v2/upload）；
  请求方式：POST；
  文件字段名：smfile（依目标图床文档而定）；
  Headers中添加：Content-Type = multipart/form-data; charset=utf-8。

4、在“获取资源所需配置”中填写：
  返回字段路径：["data", "url"]（对应SM.MS响应结构）；
  URL前缀：留空（SM.MS返回完整URL）或填入CDN域名。

5、点击“验证”按钮，上传测试图，若返回绿色成功提示且预览图可打开，则配置完成。

6、回到Typora → 偏好设置 → 图像 → 上传服务器设置中选择“uPic”，确保uPic处于运行状态，后续插入图片即触发自动上传流程。

四、使用Typora内置Gitee上传器配置

Typora原生支持Gitee上传器（v1.0+版本），无需依赖外部工具，配置简洁，适合追求极简工作流的用户。

1、确保Typora已升级至v1.0或更高版本，可通过“帮助 → 检查更新”确认。

2、在Gitee创建公开仓库（同方法二第1步），并生成私人令牌（同方法二第2步）。

3、打开Typora → “文件 → 偏好设置 → 图像”，在“上传服务器设置”中选择“Gitee”。

4、填写以下信息：
  仓库地址：https://gitee.com/用户名/仓库名.git；
  用户名：Gitee登录用户名；
  密码/令牌：第2步生成的私人令牌；
  分支：master；
  路径前缀：img/（可选）。

5、点击“验证图片上传选项”，Typora将尝试提交一张测试图至Gitee仓库根目录。

6、验证成功后，所有图片上传均由Typora内部完成，无需启动PicGo或uPic等第三方应用。