Typora插入截图后图片仅存本地导致跨设备失效,需配置PicGo图床实现自动上传:安装PicGo GUI版(路径全英文)、Typora中启用PicGo(HTTP)服务、设置对应图床参数及端口36677,再配置Typora图像行为(推荐启用复制到./${filename}.assets并勾选相对路径),最后通过【上传所有本地图片】批量转换存量图片链接。

在Windows系统中用Typora写技术笔记或博客时,插入截图后图片只存本地,换电脑、发给同事、发布到CSDN或博客园就全变叉号——这是因为路径失效,必须让每张图自动上传到公网可访问的图床并替换链接。这个过程不需要手动一张张传,只要配置到位,粘贴或插入图片瞬间完成上传。
安装PicGo并启用图床服务
Typora自身不带上传能力,需依赖PicGo作为后台图床代理。PicGo有GUI版和Core命令行版,推荐直接装GUI版(v2.3.0+),界面直观、插件管理方便,且Windows兼容性最稳。
1、前往PicGo官方GitHub Releases页,下载最新x64.exe安装包(如PicGo-2.4.0-x64.exe);
2、双击运行安装程序,【安装路径必须全英文、不含空格】,例如C:\PicGo\,否则Typora后续无法调用;
3、安装完成后先不要启动PicGo,而是立刻打开Typora → 【文件】→【偏好设置】→【图像】,在“上传服务”下拉菜单中选择【PicGo(HTTP)】,此时会自动弹出“下载PicGo”提示,点击【下载或更新】——这一步会把PicGo Core轻量版也一并部署,确保HTTP接口可用;
4、回到PicGo主界面,点击左侧【图床设置】,根据你选用的图床类型(GitHub/Gitee/阿里云OSS/七牛云等)填入对应参数;若选Gitee,注意必须提前安装gitee-uploader 1.1.2插件(在【插件设置】中搜索安装),旧版gitee插件已停用;
5、在PicGo【设置】→【应用】中确认监听端口为36677(默认值),该端口必须与Typora中PicGo(HTTP)服务的端口完全一致,否则上传请求会被静默丢弃。
配置Typora图像行为与路径绑定
本地图片能否被识别、是否触发上传,取决于Typora对路径的解析逻辑。很多用户卡在这一步:明明PicGo配置好了,但粘贴图片后还是本地路径,根本没上传——问题几乎都出在路径设置未生效。
方法一:启用自动复制+相对路径(推荐新手)
1、在Typora【偏好设置】→【图像】中,勾选【复制图片到指定文件夹】;
2、输入框填写 ./${filename}.assets(自动生成同名assets文件夹)或统一写 ./images;
3、务必勾选【优先使用相对路径】,并取消勾选【使用绝对路径】;
4、【关键前提:当前.md文档必须已保存,且路径不能是桌面或下载目录这类系统受控位置】,否则Typora无法确定基准目录,复制功能将静默失败;
让 Windows 桌面程序在开机时静默自启并隐藏到系统托盘。特别适用于 Flutter、Electron 等无视 VBS/ProcessStartInfo 窗口样式、难以隐藏的顽固应用。提供「VBS 启动器 + Python ctypes/Win32 API」的隐藏窗口方案,可稳定把窗口收进托盘且不闪控制台。
方法二:跳过复制,直传原始文件(适合已有大量图片的项目)
1、取消勾选【复制图片到指定文件夹】;
2、仍要勾选【优先使用相对路径】;
3、确保所有待传图片物理存在于文档所在目录的子路径下(如文档在D:\notes\blog.md,则图片须在D:\notes\img\abc.png);
4、此模式下Typora仅读取路径,不移动文件,上传后原地保留副本,但要求路径稳定——一旦移动文档,本地引用立即断裂,必须重新上传。
验证并批量处理存量图片
新配置只对之后插入的图片生效。已写好的文档里几十张本地图,不用手动改链接,Typora提供一键转换功能。
第一步:确认PicGo正在运行,且图床设置已测试通过(PicGo右下角托盘图标为绿色);
第二步:在Typora中打开目标.md文档,确保它已保存(.md文件存在磁盘上);
第三步:点击顶部菜单【格式】→【图像】→【上传所有本地图片】;
第四步:观察右下角状态栏,出现“上传完成”提示即成功;若某张失败,大概率是文件名含中文、开头有空格、扩展名非.png/.jpg/.jpeg/.webp,或文件本身已损坏;
第五步:上传成功后,文档内所有  会自动替换为形如  的在线地址,刷新即可实时渲染。










