PicGo 图片上传工具使用指南

1. 简介

PicGo 是一款开源的跨平台图片上传工具（支持 Windows/macOS/Linux）。它的核心价值在于解决 Markdown 写作时的“图片上云”痛点。

核心功能：

• 多图床支持：内置支持 SM.MS, GitHub, Imgur, 阿里云 OSS, 腾讯云 COS, 七牛云等。
• 拖拽上传：支持拖拽图片、剪贴板上传。
• 自动复制：上传成功后自动将 Markdown 链接复制到剪贴板。
• 插件系统：支持通过插件扩展功能（如水印、图片压缩、MinIO 支持）。
• 相册管理：可以查看和删除已上传的图片。

2. 安装

• GitHub 下载：Releases · Molunerfinn/PicGo
• Windows 用户：下载 .exe 安装包。
• macOS 用户：下载 .dmg。
• Linux 用户：下载 .AppImage。

3. 常用图床配置

3.1 GitHub 图床（免费/推荐）

GitHub 是开发者最常用的免费图床，配合 jsDelivr CDN 可以获得不错的访问速度。

前置条件：

1. 创建一个公开的 GitHub 仓库（如 my-assets）。
2. 生成一个 Personal Access Token (PAT)：
   • 访问 GitHub Settings -> Developer settings -> Tokens。
   • 点击 Generate new token。
   • 勾选 repo 权限（必须）。
   • 复制生成的 Token。

PicGo 配置步骤：

1. 打开 PicGo 设置 -> 图床设置 -> GitHub图床。
2. 填写配置：
   • 设定仓库名：username/repo-name (例如 hongj/assets)。
   • 设定分支名：通常为 main 或 master。
   • 设定Token：粘贴刚才生成的 PAT。
   • 指定存储路径：可选，例如 images/（以 / 结尾）。
   • 设定自定义域名：https://cdn.jsdelivr.net/gh/username/repo-name (推荐使用 jsDelivr 加速)。
3. 点击 确定 并 设置为默认图床。

3.2 S3 / MinIO (自建图床)

如果你有自建的 MinIO 或使用兼容 S3 协议的云存储（如 AWS S3, Cloudflare R2）。

1. 安装插件：插件设置 -> 搜索 s3 -> 安装 picgo-plugin-s3（推荐 1.1.0+ 版本）。
2. 配置插件参数：
   • AccessKeyId / SecretAccessKey: 你的密钥。
   • Bucket: 存储桶名称。
   • Region: 区域（MinIO 通常填 us-east-1 或留空）。
   • Endpoint: 自建 MinIO 的地址（如 http://minio.example.com）。
   • ForcePathStyle: MinIO 必须设为 true。

4. 与写作工具集成

4.1 Typora 集成

Typora 是 Markdown 写作神器，与 PicGo 配合可实现“截图 -> 粘贴 -> 自动上传”。

1. 打开 Typora 偏好设置 -> 图像。
2. 插入图片时：选择 “上传图片”。
3. 上传服务：选择 “PicGo (app)”。
4. 路径：选择 PicGo 的安装路径（通常会自动检测）。
5. 点击 验证图片上传选项 测试是否成功。

4.2 VS Code 集成

在 VS Code 中写 Markdown 也可以使用 PicGo。

1. 安装插件：PicGo (作者: Spades)。
2. 配置插件：
   • Picgo: Config Path: 指向 PicGo 的配置文件 (config.json)。
     • Windows 路径: C:\Users\YourName\AppData\Roaming\PicGo\data.json
   • 快捷键：默认 Ctrl + Alt + U 从剪贴板上传。
   • 或者使用 GUI 模式：直接运行 PicGo 桌面端，VS Code 插件会调用 PicGo 的 Server 接口上传。

5. 进阶功能与插件

5.1 图片压缩 (picgo-plugin-imagemin)

为了节省流量和加快加载速度，建议开启图片压缩。

1. 在 PicGo 插件设置中搜索 imagemin。
2. 安装并重启 PicGo。
3. 配置压缩质量（通常 80% 即可）。

5.2 添加水印 (picgo-plugin-watermark)

保护版权，自动添加文字或图片水印。

1. 搜索并安装 watermark 插件。
2. 配置水印文字、字体大小、位置（如 bottom-right）。
3. 注意：字体文件路径必须填写绝对路径。

5.3 配置文件手动管理

PicGo 的配置文件位于：

• Windows: %APPDATA%\PicGo\data.json
• macOS: ~/Library/Application Support/picgo/data.json

你可以备份此文件以保存所有图床配置。

6. 与 Obsidian 集成

Obsidian 是目前最流行的双链笔记工具，配合 PicGo 可以实现丝滑的图片上传体验。

6.1 安装 Image Auto Upload Plugin

1. 在 Obsidian 的 第三方插件 市场搜索 Image Auto Upload Plugin 并安装。
2. 启用插件。

6.2 配置插件

1. 打开插件设置页面。
2. Default uploader: 选择 PicGo。
3. PicGo server: 保持默认 http://127.0.0.1:36677。
4. 工作流程：
   • 将图片拖入 Obsidian 编辑器。
   • 插件会自动调用 PicGo 上传图片。
   • 上传成功后，自动将本地链接替换为网络链接。

7. 常见问题与技巧

6.1 上传失败排查

• GitHub 上传失败：
  • 检查 Token 是否过期。
  • 检查仓库名是否正确。
  • 检查文件名是否包含非法字符（建议开启“时间戳重命名”）。
  • 网络问题：GitHub API 在国内可能不稳定，尝试配置代理（PicGo 设置 -> 设置代理）。
• 端口冲突：PicGo 默认监听 36677 端口。如果 Typora 提示连接失败，检查 PicGo 设置中的 Server 端口是否被修改。
• 日志查看：在 PicGo 设置中点击“打开日志文件”，查看详细报错信息 (picgo.log)。

6.2 图片重命名

建议在 PicGo 设置 中开启 “上传前重命名” 或 “时间戳重命名”，避免因文件名重复导致上传失败或覆盖。

6.3 无法粘贴上传

如果剪贴板中的图片是文件路径而非图片数据（例如直接复制文件），PicGo 可能无法识别。建议使用截图工具（Snipaste）截图后复制，或直接拖拽文件到 PicGo 悬浮窗。

参考资料

• PicGo 官方文档
• Typora + PicGo + GitHub 搭建图床
• Awesome PicGo Plugins