Typora + PicGo + Gitee图床——图片自动上传详细教程

什么是图床？

图床（Image Hosting）是一种专门用来存储图片的网络服务，它可以将图片上传到云端服务器，然后提供一个网络链接（URL）来访问这张图片。

图床的作用

• 节省本地存储空间：图片存储在云端，不占用本地硬盘空间
• 跨平台访问：通过网络链接，任何设备都可以访问图片
• 提高文档传输效率：Markdown文档只包含图片链接，文件体积小
• 便于分享：包含图片的文档可以轻松分享给他人

Typora中的图床问题

1. 本地图片的问题

当您在Typora中插入本地图片时，会遇到以下问题：

![图片描述](C:\Users\用户名\Pictures\image.png)

问题：

• 图片路径是绝对路径，只在您的电脑上有效
• 分享文档给他人时，他人看不到图片
• 移动文档位置后，图片链接失效

2. 相对路径的局限性

使用相对路径虽然比绝对路径好，但仍有限制：

![图片描述](./images/image.png)

问题：

• 需要同时传输文档和图片文件夹
• 文件夹结构必须保持一致
• 在线平台（如GitHub、博客）可能无法正确显示

本教程将详细介绍如何配置Typora + PicGo + Gitee的图床方案，实现在Typora中插入图片时自动上传到Gitee仓库，并自动替换为网络链接。这个方案的优势是：

• 完全免费：Gitee提供免费的Git仓库服务
• 国内访问速度快：Gitee服务器在国内，访问速度优秀
• 自动化程度高：配置完成后，插入图片即可自动上传
• 稳定可靠：基于Git版本控制，图片不会丢失

准备工作

1. 所需软件

• Typora：Markdown编辑器
• PicGo：图片上传工具
• Git：版本控制工具（可选，建议安装）

2. 账号准备

• Gitee账号：用于创建仓库存储图片

第一步：创建Gitee仓库

1. 登录Gitee

• 访问 https://gitee.com/
• 登录您的Gitee账号（如果没有账号，请先注册）

2. 创建新仓库

1. 点击右上角的"+“号，选择"新建仓库”
2. 填写仓库信息：
   • 仓库名称：例如 my-images 或 pic-bed
   • 仓库介绍：图床仓库（可选）
   • 仓库类型：选择"公开"（重要！私有仓库无法作为图床）
   • 初始化仓库：勾选"使用Readme文件初始化这个仓库"
3. 点击"创建"

3. 获取仓库信息

创建完成后，记录以下信息：

• 仓库地址：https://gitee.com/用户名/仓库名
• 用户名：您的Gitee用户名
• 仓库名：刚创建的仓库名称

第二步：生成Gitee访问令牌

1. 进入设置页面

1. 点击右上角头像，选择"设置"
2. 在左侧菜单中选择"私人令牌"

2. 生成新令牌

1. 点击"生成新令牌"
2. 填写令牌信息：
   • 令牌描述：例如 “PicGo图床”
   • 权限范围：勾选以下权限
     • projects：访问项目
     • pull_requests：访问Pull Request
     • issues：访问Issue
     • notes：访问评论
     • keys：访问公钥
     • hook：访问WebHook
3. 点击"提交"

3. 保存令牌

重要：生成的令牌只会显示一次，请立即复制并保存到安全的地方！

示例令牌：1234567890abcdef1234567890abcdef12345678

第三步：安装和配置PicGo

1. 下载PicGo

• 访问官方发布页：https://github.com/Molunerfinn/PicGo/releases
• 下载适合您系统的版本：
  • Windows：选择 .exe 文件
  • macOS：选择 .dmg 文件
  • Linux：选择 .AppImage 文件

2. 安装PicGo

• Windows：双击 .exe 文件安装
• macOS：双击 .dmg 文件，拖拽到Applications文件夹
• Linux：给 .AppImage 文件添加执行权限后运行

3. 安装Gitee插件

1. 打开PicGo
2. 点击左侧"插件设置"
3. 在搜索框中输入"gitee"
4. 找到"gitee-uploader"插件，点击"安装"
5. 安装完成后，重启PicGo

4. 配置Gitee图床

1. 在PicGo中点击"图床设置"
2. 选择"Gitee图床"
3. 填写配置信息：

{"repo": "用户名/仓库名","token": "您的Gitee访问令牌","path": "images/","customUrl": "","branch": "master"
}

详细说明：

• repo：格式为 用户名/仓库名，例如 zhangsan/my-images
• token：刚才生成的Gitee访问令牌
• path：图片存储路径，建议使用 images/ 或 pics/
• customUrl：自定义域名，一般留空
• branch：分支名，默认为 master

5. 设置为默认图床

1. 配置完成后，点击"确定"
2. 在"图床设置"中将"Gitee图床"设为默认图床

第四步：配置Typora

1. 打开Typora偏好设置

• Windows/Linux：文件 → 偏好设置
• macOS：Typora → 偏好设置

2. 配置图像上传

1. 点击左侧"图像"选项
2. 在"插入图片时"选择"上传图片"
3. 在"上传服务"中选择"PicGo(app)"
4. 设置PicGo路径：
   • Windows：通常在 C:\Users\用户名\AppData\Local\Programs\PicGo\PicGo.exe
   • macOS：通常在 /Applications/PicGo.app/Contents/MacOS/PicGo
   • Linux：PicGo AppImage文件的完整路径

3. 测试配置

1. 点击"验证图片上传选项"
2. 如果显示"验证成功"，说明配置正确
3. 如果失败，检查PicGo路径是否正确，以及PicGo是否正在运行

第五步：使用测试

1. 插入图片测试

1. 在Typora中新建文档
2. 插入图片的几种方式：
   • 直接拖拽图片到编辑器
   • 使用快捷键 Ctrl+Shift+I（Windows/Linux）或 Cmd+Shift+I（macOS）
   • 复制图片后粘贴 Ctrl+V
   • 使用菜单 格式 → 图像 → 插入图像

2. 验证上传结果

1. 插入图片后，Typora会自动调用PicGo上传
2. 上传成功后，图片链接会自动替换为Gitee链接
3. 链接格式类似：https://gitee.com/用户名/仓库名/raw/master/images/图片名.jpg

3. 检查Gitee仓库

1. 访问您的Gitee仓库
2. 进入 images 文件夹
3. 确认图片已成功上传

常见问题及解决方案

1. 上传失败：401 Unauthorized

原因：访问令牌无效或权限不足
解决方案：

• 重新生成Gitee访问令牌
• 确保勾选了足够的权限
• 重新配置PicGo中的token

2. 上传失败：404 Not Found

原因：仓库名或用户名错误
解决方案：

• 检查PicGo配置中的repo格式
• 确认仓库名和用户名拼写正确
• 确保仓库是公开的

3. 图片无法显示

原因：仓库为私有或链接错误
解决方案：

• 确保仓库设置为公开
• 检查生成的图片链接是否正确
• 尝试在浏览器中直接访问图片链接

4. PicGo无法启动

原因：路径配置错误或软件冲突
解决方案：

• 重新设置PicGo路径
• 以管理员身份运行PicGo
• 检查防火墙设置

5. 上传速度慢

原因：网络问题或图片过大
解决方案：

• 压缩图片大小
• 选择网络较好的时间段上传
• 考虑使用其他图床服务

高级配置

1. 自定义上传路径

在PicGo的Gitee配置中，可以设置更复杂的路径规则：

{"path": "images/{year}/{month}/"
}

这样会按年月创建文件夹，便于管理。

2. 图片重命名

在PicGo的"重命名"设置中，可以配置图片命名规则：

• {timestamp}：时间戳
• {hash}：文件哈希值
• {origin}：原始文件名

3. 图片压缩

在PicGo插件中心安装压缩插件，可以在上传前自动压缩图片。

4. 批量上传

PicGo支持批量上传功能，可以一次性上传多张图片。

最佳实践建议

1. 仓库管理

• 定期备份：虽然Git本身就是备份，但建议定期克隆仓库到本地
• 分类存储：使用不同的文件夹分类存储图片
• 清理无用图片：定期清理不再使用的图片

2. 图片优化

• 控制大小：建议单张图片不超过1MB
• 选择合适格式：网页用途优先选择JPG或WebP
• 压缩处理：上传前适当压缩图片

3. 安全考虑

• 保护令牌：不要在公开场合泄露访问令牌
• 定期更新：定期更新访问令牌
• 权限最小化：只授予必要的权限

4. 使用技巧

• 快捷键：熟练使用Typora的图片插入快捷键
• 批量处理：对于大量图片，可以使用PicGo的批量上传功能
• 预览确认：上传后及时预览确认图片显示正常

故障排查清单

遇到问题时，请按以下顺序检查：

1. 网络连接：确保网络正常，可以访问Gitee
2. PicGo状态：确认PicGo正在运行且配置正确
3. Gitee仓库：确认仓库存在且为公开状态
4. 访问令牌：确认令牌有效且权限足够
5. Typora配置：确认PicGo路径设置正确
6. 图片格式：确认图片格式被支持（JPG、PNG、GIF等）
7. 文件大小：确认图片大小在合理范围内

总结

通过本教程，您已经学会了如何配置Typora + PicGo + Gitee的图床方案。这个方案具有免费、快速、稳定的特点，非常适合个人博客、学习笔记等场景使用。

配置完成后，您就可以在Typora中愉快地插入图片，而不用担心图片分享和存储问题了。记住定期备份重要图片，并注意保护好您的访问令牌。