一、前言日常使用Typora写Markdown笔记、技术博客时大家都会遇到一个痛点本地图片只能本机查看换电脑、发博客、分享文档后图片全部失效。市面上大部分免费图床要么限速、要么经常炸图、要么需要付费扩容。而Gitee作为国内稳定的代码托管平台访问速度快、永久免费、无外链防盗链限制搭配PicGo可以实现Typora截图/粘贴/拖拽图片全自动云端上传写完笔记无需手动处理图片极大提升写作效率。本文全程实操零基础跟着一步步操作5分钟即可配置完成适配Windowsamp;Mac双系统。二、最终实现效果截图CtrlV、拖拽图片、粘贴图片全程无感自动上传本地图片自动替换为Gitee在线cdn链接文档无本地依赖国内访问秒开图片永久保存不会出现挂图、404问题全程免费无需第三方付费图床个人开发者完全够用三、前期准备Gitee仓库与私人令牌配置3.1 新建公开图片仓库打开Gitee官网https://gitee.com登录个人账号点击页面右上角【】号选择【新建仓库】仓库参数填写关键仓库名称自定义推荐picture\-bed仓库可见性必须选择公开私有仓库无法外链访问图片初始化选项勾选使用README文件初始化其余默认即可点击创建等待仓库生成完毕3.2 生成Gitee私人令牌Token点击个人头像 → 设置 → 左侧找到【私人令牌】点击【生成新令牌】令牌描述随意填写例如typora图片上传权限只需要勾选projects仓库读写权限足够点击提交立即复制保存令牌关闭页面后无法再次查看重要提醒令牌不要泄露、不要随意分享任何人拿到令牌都可以操作你的Gitee仓库四、环境安装Node.js PicGo-Core4.1 安装Node.js运行环境PicGo命令行工具依赖Node.js环境没有环境无法正常运行。前往Node.js官网下载LTS长期稳定版本https://nodejs.org/默认下一步安装即可无需修改任何配置打开终端/CMD输入以下命令验证是否安装成功node-vnpm-v输出版本号即代表环境正常。4.2 全局安装PicGo-Core命令行工具本次不使用臃肿的图形化PicGo轻量化命令行版本稳定性更强适配Typora更好。npminstallpicgo-g安装完成后输入以下命令校验picgo-v五、安装Gitee图床插件并配置参数5.1 安装Gitee专属上传插件picgoinstallgitee-uploader出现Plugin installed successfully即为插件安装成功。5.2 配置Gitee图床核心参数终端输入命令开始交互式配置picgosetuploader按照下方提示依次选择/填写全程照着抄即可选择上传图床选中gitee回车配置名称直接回车默认repo填写你的Gitee用户名/仓库名例zhangsan/picture-bedbranch填写仓库主分支一般为maintoken粘贴刚才保存的Gitee私人令牌path图片存放目录填写img/自动归类图片customPath、customUrl全部直接回车跳过5.3 设置默认图床测试上传# 设置默认上传图床为giteepicgo use uploader# 测试单张图片上传替换为本地真实图片路径即可picgo upload 本地图片路径终端返回Gitee在线图片链接说明图床配置完全成功。六、Typora软件关联配置核心步骤打开Typora → 文件 → 偏好设置 → 图像插入图片时选择上传图片勾选下方两个选项对本地/网络图片均启用上传规则上传服务选择Custom Command自定义命令获取PicGo绝对路径解决命令找不到报错很多人配置失败都是因为只填picgo upload环境变量不识别必须填写绝对路径Mac终端输入which picgoWindows CMD输入where picgo复制输出的完整路径拼接upload填入自定义命令输入框示例/usr/local/bin/picgo upload最后点击【验证图片上传选项】提示验证成功即可全部配置完成。七、常见报错一站式解决报错1picgo: command not found原因Typora无法识别系统环境变量解决方案使用上面查到的绝对路径填入自定义命令。报错2图片上传成功但是网页打开404原因Gitee仓库设置为私有解决方案仓库设置中修改为公开仓库。报错3上传超时、连接中断原因本地网络波动解决方案切换稳定网络重新点击验证即可。八、总结这套TyporaPicGoGitee图床方案非常适合国内开发者免费、稳定、访问快、无广告、不限流量。配置完成之后后续写博客、写笔记完全不用关心图片问题截图粘贴自动云端托管迁移文档、发布CSDN/掘金等平台再也不会出现图片丢失问题大幅提升日常写作效率。配置过程中有任何问题欢迎评论区留言交流~标签Typora PicGo Gitee图床 Markdown工具 笔记工具
Mac + Typora + Gitee:粘贴图片自动上传,告别本地管理
发布时间:2026/5/28 22:12:48
一、前言日常使用Typora写Markdown笔记、技术博客时大家都会遇到一个痛点本地图片只能本机查看换电脑、发博客、分享文档后图片全部失效。市面上大部分免费图床要么限速、要么经常炸图、要么需要付费扩容。而Gitee作为国内稳定的代码托管平台访问速度快、永久免费、无外链防盗链限制搭配PicGo可以实现Typora截图/粘贴/拖拽图片全自动云端上传写完笔记无需手动处理图片极大提升写作效率。本文全程实操零基础跟着一步步操作5分钟即可配置完成适配Windowsamp;Mac双系统。二、最终实现效果截图CtrlV、拖拽图片、粘贴图片全程无感自动上传本地图片自动替换为Gitee在线cdn链接文档无本地依赖国内访问秒开图片永久保存不会出现挂图、404问题全程免费无需第三方付费图床个人开发者完全够用三、前期准备Gitee仓库与私人令牌配置3.1 新建公开图片仓库打开Gitee官网https://gitee.com登录个人账号点击页面右上角【】号选择【新建仓库】仓库参数填写关键仓库名称自定义推荐picture\-bed仓库可见性必须选择公开私有仓库无法外链访问图片初始化选项勾选使用README文件初始化其余默认即可点击创建等待仓库生成完毕3.2 生成Gitee私人令牌Token点击个人头像 → 设置 → 左侧找到【私人令牌】点击【生成新令牌】令牌描述随意填写例如typora图片上传权限只需要勾选projects仓库读写权限足够点击提交立即复制保存令牌关闭页面后无法再次查看重要提醒令牌不要泄露、不要随意分享任何人拿到令牌都可以操作你的Gitee仓库四、环境安装Node.js PicGo-Core4.1 安装Node.js运行环境PicGo命令行工具依赖Node.js环境没有环境无法正常运行。前往Node.js官网下载LTS长期稳定版本https://nodejs.org/默认下一步安装即可无需修改任何配置打开终端/CMD输入以下命令验证是否安装成功node-vnpm-v输出版本号即代表环境正常。4.2 全局安装PicGo-Core命令行工具本次不使用臃肿的图形化PicGo轻量化命令行版本稳定性更强适配Typora更好。npminstallpicgo-g安装完成后输入以下命令校验picgo-v五、安装Gitee图床插件并配置参数5.1 安装Gitee专属上传插件picgoinstallgitee-uploader出现Plugin installed successfully即为插件安装成功。5.2 配置Gitee图床核心参数终端输入命令开始交互式配置picgosetuploader按照下方提示依次选择/填写全程照着抄即可选择上传图床选中gitee回车配置名称直接回车默认repo填写你的Gitee用户名/仓库名例zhangsan/picture-bedbranch填写仓库主分支一般为maintoken粘贴刚才保存的Gitee私人令牌path图片存放目录填写img/自动归类图片customPath、customUrl全部直接回车跳过5.3 设置默认图床测试上传# 设置默认上传图床为giteepicgo use uploader# 测试单张图片上传替换为本地真实图片路径即可picgo upload 本地图片路径终端返回Gitee在线图片链接说明图床配置完全成功。六、Typora软件关联配置核心步骤打开Typora → 文件 → 偏好设置 → 图像插入图片时选择上传图片勾选下方两个选项对本地/网络图片均启用上传规则上传服务选择Custom Command自定义命令获取PicGo绝对路径解决命令找不到报错很多人配置失败都是因为只填picgo upload环境变量不识别必须填写绝对路径Mac终端输入which picgoWindows CMD输入where picgo复制输出的完整路径拼接upload填入自定义命令输入框示例/usr/local/bin/picgo upload最后点击【验证图片上传选项】提示验证成功即可全部配置完成。七、常见报错一站式解决报错1picgo: command not found原因Typora无法识别系统环境变量解决方案使用上面查到的绝对路径填入自定义命令。报错2图片上传成功但是网页打开404原因Gitee仓库设置为私有解决方案仓库设置中修改为公开仓库。报错3上传超时、连接中断原因本地网络波动解决方案切换稳定网络重新点击验证即可。八、总结这套TyporaPicGoGitee图床方案非常适合国内开发者免费、稳定、访问快、无广告、不限流量。配置完成之后后续写博客、写笔记完全不用关心图片问题截图粘贴自动云端托管迁移文档、发布CSDN/掘金等平台再也不会出现图片丢失问题大幅提升日常写作效率。配置过程中有任何问题欢迎评论区留言交流~标签Typora PicGo Gitee图床 Markdown工具 笔记工具