Mac + Typora + Gitee：粘贴图片自动上传，告别本地管理

一、前言

日常使用Typora写Markdown笔记、技术博客时，大家都会遇到一个痛点：本地图片只能本机查看，换电脑、发博客、分享文档后图片全部失效。

市面上大部分免费图床要么限速、要么经常炸图、要么需要付费扩容。而Gitee作为国内稳定的代码托管平台，访问速度快、永久免费、无外链防盗链限制，搭配PicGo可以实现Typora截图/粘贴/拖拽图片全自动云端上传，写完笔记无需手动处理图片，极大提升写作效率。

本文全程实操，零基础跟着一步步操作，5分钟即可配置完成，适配Windows&Mac双系统。

二、最终实现效果

截图Ctrl+V、拖拽图片、粘贴图片，全程无感自动上传
本地图片自动替换为Gitee在线cdn链接，文档无本地依赖
国内访问秒开，图片永久保存，不会出现挂图、404问题
全程免费，无需第三方付费图床，个人开发者完全够用

三、前期准备：Gitee仓库与私人令牌配置

3.1 新建公开图片仓库

打开Gitee官网：https://gitee.com，登录个人账号
点击页面右上角【+】号，选择【新建仓库】
仓库参数填写（关键）：
- 仓库名称：自定义，推荐 picture\-bed
- 仓库可见性：必须选择公开（私有仓库无法外链访问图片）
- 初始化选项：勾选使用README文件初始化，其余默认即可
点击创建，等待仓库生成完毕

3.2 生成Gitee私人令牌Token

点击个人头像 → 设置 → 左侧找到【私人令牌】
点击【生成新令牌】
令牌描述：随意填写，例如typora图片上传
权限只需要勾选：projects（仓库读写权限足够）
点击提交，立即复制保存令牌，关闭页面后无法再次查看

重要提醒：令牌不要泄露、不要随意分享，任何人拿到令牌都可以操作你的Gitee仓库

四、环境安装：Node.js + PicGo-Core

4.1 安装Node.js运行环境

PicGo命令行工具依赖Node.js环境，没有环境无法正常运行。

前往Node.js官网下载LTS长期稳定版本：https://nodejs.org/
默认下一步安装即可，无需修改任何配置
打开终端/CMD，输入以下命令验证是否安装成功：

bash 复制代码

node -v
npm -v

输出版本号即代表环境正常。

4.2 全局安装PicGo-Core命令行工具

本次不使用臃肿的图形化PicGo，轻量化命令行版本稳定性更强，适配Typora更好。

bash 复制代码

npm install picgo -g

安装完成后，输入以下命令校验：

bash 复制代码

picgo -v

五、安装Gitee图床插件并配置参数

5.1 安装Gitee专属上传插件

bash 复制代码

picgo install gitee-uploader

出现 Plugin installed successfully 即为插件安装成功。

5.2 配置Gitee图床核心参数

终端输入命令开始交互式配置：

bash 复制代码

picgo set uploader

按照下方提示依次选择/填写，全程照着抄即可：

选择上传图床：选中 gitee，回车
配置名称：直接回车默认
repo：填写 你的Gitee用户名/仓库名 例：zhangsan/picture-bed
branch：填写仓库主分支，一般为main
token：粘贴刚才保存的Gitee私人令牌
path：图片存放目录，填写img/，自动归类图片
customPath、customUrl：全部直接回车跳过

5.3 设置默认图床+测试上传

bash 复制代码

# 设置默认上传图床为gitee
picgo use uploader

# 测试单张图片上传，替换为本地真实图片路径即可
picgo upload 本地图片路径

终端返回Gitee在线图片链接，说明图床配置完全成功。

六、Typora软件关联配置（核心步骤）

打开Typora → 文件 → 偏好设置 → 图像
插入图片时选择：上传图片
勾选下方两个选项：对本地/网络图片均启用上传规则
上传服务选择：Custom Command（自定义命令）

获取PicGo绝对路径（解决命令找不到报错）

很多人配置失败都是因为只填picgo upload，环境变量不识别，必须填写绝对路径：

Mac终端输入：which picgo
Windows CMD输入：where picgo

复制输出的完整路径，拼接upload，填入自定义命令输入框：

bash 复制代码

示例：/usr/local/bin/picgo upload

最后点击【验证图片上传选项】，提示验证成功即可全部配置完成。

七、常见报错一站式解决

报错1：picgo: command not found

原因：Typora无法识别系统环境变量，解决方案：使用上面查到的绝对路径填入自定义命令。

报错2：图片上传成功，但是网页打开404

原因：Gitee仓库设置为私有，解决方案：仓库设置中修改为公开仓库。

报错3：上传超时、连接中断

原因：本地网络波动，解决方案：切换稳定网络，重新点击验证即可。

八、总结

这套Typora+PicGo+Gitee图床方案，非常适合国内开发者：免费、稳定、访问快、无广告、不限流量。

配置完成之后，后续写博客、写笔记完全不用关心图片问题，截图粘贴自动云端托管，迁移文档、发布CSDN/掘金等平台再也不会出现图片丢失问题，大幅提升日常写作效率。

配置过程中有任何问题，欢迎评论区留言交流~

标签：Typora PicGo Gitee图床 Markdown工具笔记工具