Typora 配置 PicGo 使用 Gitee 图床实现图片自动上传（Mac 详细教程）
Typora+PicGo+Gitee搭建属于自己的图床MAC版
- 问题: 用typora写完笔记,但是上传其他的笔记平台的时候,图片处理起来很麻烦,
此方法可以解决你的烦恼. github没有魔法国内使用体验不佳, 所以采用gitee替换 - Gitee 作为国内代码托管平台（类似 GitHub），速度快、访问稳定，非常适合国内笔记 / 博客用户用来存图片。
一、 Gitee 作为图床的原理
把图片上传到 Gitee 仓库中，然后通过图片的 原始链接（Raw URL） 访问它。
Typora、PicGo 等工具都可以自动完成上传 + 链接替换。
例子：
https://gitee.com/yourname/image-repo/raw/master/img/test.png
这类链接可以直接在网页（如 CSDN、掘金等）中访问和显示图片。
二、基础使用方法（适合 Typora / PicGo）
1、 创建一个公开仓库
- 登录 Gitee → 点击右上角 “+” → “新建仓库”
- 仓库名如：image-host
- 必须设置为 公开（Public），否则图片外链无法访问。
2、 生成访问令牌（Token）
- 进入 Gitee → 个人设置 → “安全设置” → “私人令牌（Personal Access Token）”
- 新建一个 Token，勾选：
repos, notes, issues, pull_requests
- 复制生成的 Token（只显示一次, 存到到备忘录一会用)。
3、安装并配置 PicGo
- 下载对应的mac版
- 下载后, 安装如果显示这个
- PicGo 没有通过苹果的「开发者签名认证」，macOS 默认会认为这是“不受信任来源的应用”。
打开终端执行
sudo xattr -rd com.apple.quarantine /Applications/PicGo.app
| sudo | 以管理员权限执行命令（需要输入密码） |
|---|---|
| xattr | macOS 自带的命令，用于查看或修改文件的“扩展属性”（extended attributes） |
| -r | 表示递归操作（recursive），作用于文件夹内所有文件 |
| -d | 表示删除指定的属性（delete） |
| com.apple.quarantine | 这个属性名就是苹果系统添加的“隔离标记” |
| /Applications/PicGo.app | 要操作的目标文件路径，也就是 PicGo 的安装位置 |
打开后, 会在顶部显示, 这时候还需要下载一个插件,才能完成图片自动上传到gitee
4、安装配置插件(显示gitee选项和gitee自动上传)
在 PicGo 设置 → 插件设置 → 搜索并安装：
picgo-plugin-gitee-uploader
- 如果不能搜到就需要用命令行来安装(安装后重启即可看到)
cd ~/Library/Application\ Support/picgo # picgo插件存放的位置
npm install picgo-plugin-gitee-uploader #用npm下载这个插件#没有npm工具可以用homebrew安装
brew install node
✔️ npm 是 Node.js 自带的包管理器，当你安装 Node.js 时，npm 会自动一并安装。
填写：
| 参数 | 示例 |
|---|---|
| 仓库名 | yourname/image-host |
| 分支名 | master |
| Token | （刚才生成的 Token） |
| 存储路径 | img/ |
| 自定义域名(方便回显) | https://gitee.com/yourname/image-host/raw/master |
随便上传一个图片,然后去你刚才gitee创建的仓库中看看有没有
5、 配置 Typora
设置 → 图像 → 上传图片 → 图像上传服务选择 “PicGo (app)” 配置完成你在粘贴图片会自动上传并回显示
三、优点与缺点分析
| 项目 | 优点 | 缺点 |
|---|---|---|
| ✅ 访问速度快 | 国内 CDN，加载非常快 | — |
| ✅ 操作简单 | 可直接用 PicGo 上传 | — |
| ✅ CSDN/掘金兼容好 | 外链可直接显示 | — |
| ⚠️ 仓库需公开 | 私有仓库外链无法访问 | 图片有隐私风险 |
| ⚠️ 有时触发防盗链 | 某些平台（知乎）会屏蔽 raw 链接 | 可通过反向代理或 CDN 解决 |
| ⚠️ 空间有限 | 免费账户存储空间有限（1GB） | 图片太多时需分仓或清理 |
四、建议实践方案
| 需求 | 推荐方案 |
|---|---|
| 个人笔记、CSDN、掘金 | ✅ Gitee 图床（速度快、稳定） |
| 私密文档 / 公司项目 | 🚫 不建议（公开仓库才能访问） |
| 跨国博客（中外访问） | 🌍 GitHub + jsDelivr |
| 高可靠性 / 企业用途 | ☁️ 阿里 OSS / 腾讯 COS |
五、补充(你的仓库删除了, 也不会影响已经上传到csdn的图片)
- 当你把文章发布到 CSDN 时，平台会自动替换外部图片链接为它自己的 csdnimg.cn 链接。
为什么 CSDN 会自动替换图片链接？
机制逻辑
1️⃣ 你在 Markdown 或 HTML 中插入图片：
2️⃣ 当你在 CSDN 编辑器中预览 / 保存 / 发布时，
CSDN 会扫描文章中的所有图片链接。
3️⃣ 如果发现图片来自外站（比如 Gitee、GitHub、SM.MS 等），
CSDN 会自动下载那张图片，
再上传到它自己的图片服务器（i-blog.csdnimg.cn）。
4️⃣ 然后它会自动替换 Markdown 链接为：
这样文章在 CSDN 平台上完全使用自家的图床资源。
主要是为了：
| 目的 | 说明 |
|---|---|
| ✅ 提高图片加载速度 | 自家的 CDN 更快，特别是在国内访问 |
| ✅ 避免外链失效 | 如果你删掉 Gitee 仓库，CSDN 依然能显示图片 |
| ✅ 内容安全 | 避免外部图片被篡改或带恶意脚本 |
| ✅ 图片防盗链 | Gitee、GitHub 对频繁访问的外链可能封禁，CSDN 自托管更稳定 |