超详细！PicGo+GitCode+Typora 图床搭建全攻略（新手友好版）

一、为什么选这组组合？

对于程序员、笔记爱好者或技术写作者来说，使用 Markdown 写作时，图片的存储与同步一直是核心痛点——本地图片无法跨设备访问，直接插入网络图片又可能面临失效、丢失的风险。

图床（Image Hosting）则能完美解决这一问题：通过将图片上传至远程服务器并生成稳定可访问的外链，实现「一次上传、多端复用」。而在国内网络环境下，「PicGo+GitCode+Typora」 的组合堪称性价比拉满的图床解决方案，核心优势如下：

• 免费无限制：GitCode 提供免费公开仓库，图片永久存储，无流量 / 容量限制
• 国内加速：GitCode 服务器位于国内，相比 GitHub 加载速度快 50%+，无需科学上网
• 无缝集成：Typora 粘贴 / 拖拽图片自动上传，无需手动处理链接
• 版本可控：GitCode 自带版本管理，图片修改、回滚更方便
• 可自定义：支持图片分类存储、CDN 加速、批量管理，灵活适配不同场景

这套组合的搭建门槛极低，全程无需复杂命令，新手仅需 10 分钟就能完成配置，拥有一个 免费、稳定、高速 的专属图床，彻底告别 Markdown 写作的图片管理烦恼。后续跨设备访问时，只需在其他设备上同步 Typora 文档，图片外链即可自动生效，真正实现「一次配置，终身可用」！

二、安装必备工具

1. 安装 PicGo（图片上传工具）

下载 PicGo 安装包

PicGo 是开源免费工具，支持 Windows/macOS/Linux 系统，建议优先下载官网最新稳定版，避免安装包异常：

• Windows 系统：选择后缀为 .exe 的安装包
• macOS 系统：选择后缀为 .dmg 的安装包
• Linux 系统：选择对应发行版的包

根据自身系统选择匹配的安装包类型：

打开 PicGo 官方指南的下载入口：PicGo 下载

安装 PicGo（以 Windows 为例）

1. PicGo 主界面如下：

点击完成启动 PicGo，Windows 可在右下角托盘找到图标，macOS 可在顶部菜单栏找到图标，说明安装成功：

选择安装路径，点击「安装」：

双击安装包：

2. 安装 Node.js（PicGo 插件依赖环境）

后续配置 GitCode 图床需安装专用插件，而插件安装依赖 Node.js 环境，必须提前安装：

打开终端（Windows 按 Win+R 输入 cmd），分别执行命令 node -v 和 npm -v，若显示版本号（如 v18.18.1），说明安装成功。

双击安装包，Windows 勾选“Add to PATH”（自动配置环境变量），macOS 默认配置，一路“下一步”完成安装；

官网下载，选择 LTS 长期支持版（稳定），根据系统选择安装包；

3. 安装 Typora（Markdown 编辑器）

Typora 支持免费试用，官网下载最新版，根据系统选择安装包，安装流程简单（Windows 下一步到底，macOS 拖拽至应用程序），此处不赘述。

三、配置 GitCode 仓库

我们需要在 GitCode 创建一个公开仓库，用于存放上传的图片（私有仓库无法生成公开外链，导致图片无法访问）。

1. 创建 GitCode 图片仓库

1. 仓库名称：自定义（如 image-host、pic-bed，建议英文）；
2. 仓库描述：可选（如“个人图床，用于存放 Markdown 图片”）；
3. 可见性：必须选「公开」（私有仓库外链无法访问）；

点击「创建仓库」，等待页面跳转至仓库详情页，说明仓库创建成功。

填写仓库信息（关键参数务必正确）：

登录 GitCode 官网，点击右上角「+」图标，选择「新建仓库」：

2. 生成 GitCode 访问令牌（授权 PicGo 访问）

PicGo 需通过 Token 授权访问 GitCode 仓库，Token 仅显示一次，务必保存好。

1. 在左侧菜单找到「安全设置」-「私人令牌（Personal Access Token）」，点击「生成新令牌」；
2. 配置令牌信息：
   1. 备注：自定义（如 picgo-token，用于区分用途）；
   2. 有效期：建议选「永久」（避免定期重新生成，若追求安全可选短期）；
   3. 权限：必须勾选「repo」（仓库读写权限，包含子权限），其他权限可取消；

点击「新建访问令牌」，页面会显示一串字符（即 Token），立即复制并保存到记事本（后续配置需用，刷新页面后无法再次查看）。

登录 GitCode 后，点击右上角头像，选择「设置」；

四、配置 PicGo 关联 GitCode

通过 PicGo 的 GitCode 插件，实现图片自动上传至 GitCode 仓库，步骤如下：

1. 安装 GitCode 上传插件

1. 启动 PicGo，点击主界面左侧「插件设置」；
2. 点击「安装」，等待安装完成后，重启 PicGo（插件生效需重启）。

在搜索框输入「gitcode」，找到对应插件：

2. 配置 GitCode 图床参数

1. 点击主界面左侧「图床设置」，选择「gitcode」（插件安装成功后才会显示）；
2. 填写完成后，点击「确定」保存配置，再点击「设为默认图床」（后续上传默认使用 GitCode）。

填写配置参数（参考示例，替换为自己的信息）：

点击【Default】或+号新增一个配置：

3. 测试 PicGo 图片上传功能

查看 GitCode 仓库可以看到上传成功的图片：

若上传成功，PicGo 会弹出「上传成功」提示：

打开 PicGo 主界面，点击「上传区」，拖拽一张本地图片到上传框，或点击「选择文件」选择图片；

五、配置 Typora 关联 PicGo（实现自动上传）

完成 PicGo 配置后，需让 Typora 与 PicGo 联动，实现「粘贴图片即自动上传」，无需手动打开 PicGo 操作。

1. 插入图片时：
   • 选择「上传图片」
   • 勾选「对本地图片应用上述规则」「自动上传图片」「插入时自动转义图片URL」
2. 上传服务设定：
   • 上传服务选择「PicGo (app)」
   • PicGo 路径：选择 PicGo 安装路径

点击「验证图片上传选项」，若弹出「验证成功」提示，说明 Typora 与 PicGo 关联成功：

在左侧菜单选择「图像」，配置以下参数：

启动 Typora，点击顶部菜单栏「文件」-「偏好设置」（Windows）；

六、全流程测试：从粘贴到访问的完整验证

测试「Typora 粘贴图片 → 自动上传至 GitCode → 生成外链」全流程：

额外验证：打开 GitCode 对应的图片仓库，进入 images 文件夹（或自定义路径），能看到刚刚上传的图片文件，进一步确认成功。

截图一张图片（或选择本地图片），按 Ctrl+V（Windows）粘贴到 Typora 中，粘贴后图片会短暂显示“上传中”，随后显示图片，此时点击图片，右键选择「复制图片链接」，粘贴到浏览器中，若能正常显示，说明全流程搭建成功；

打开 Typora，新建一个 Markdown 文件；

七、进阶优化：super-prefix 插件实现图片自动分类

使用 super-prefix 插件可以为上传的图片自动添加动态前缀（如日期、自定义路径），可彻底实现图片的「上传即分类」，避免图片堆积在同一文件夹，后续管理图片时按路径查找即可，极大提升图床的整洁度和可用性！

1. 安装 super-prefix 插件

1. 打开 PicGo 主界面，点击左侧「插件设置」：

在搜索框输入「super-prefix」，找到插件后点击「安装」：

2. 配置按「年 / 月」自动分类

1. 点击「确定」保存配置。

在前缀格式框输入 YYYY/MM/，插件会自动拼接前缀与 GitCode 图床配置中的 path（如 path 设为 images/，前缀设为 2025/12/，最终路径为 images/2025/12/），实现按**日期（年/月）**分类：

super-prefix 插件支持设置图片的「文件名前缀格式」和「文件名格式」：

两个核心字段的功能如下：

点击左侧「插件设置」，找到已安装的「super-prefix」，点击「设置」，点击「配置plugin-picgo-plugin-super-prefix」：

3. 验证自动分类效果

上传成功后，打开 GitCode 对应的图片仓库，图片会存入 images/2025/12/22/ 文件夹：

进入 PicGo 主界面，上传一张测试图片（拖拽或选择文件）；

八、总结

至此，「PicGo+GitCode+Typora」图床体系已全部搭建完成。通过这套方案，我们已拥有一个免费、稳定、高速的专属图床，实现了 Markdown 写作时 “粘贴图片即上传” 的无缝体验，彻底解决了图片跨设备同步、存储失效等痛点。

这套图床方案经过多次验证，适配 2025 年最新版本的工具与平台，且后续无需频繁维护，真正做到 “一次配置，长期可用”。如果在使用中遇到其他问题，可在 GitCode 社区或 PicGo 官方文档中查找解决方案，也欢迎分享你的使用经验！

祝大家写作顺利，彻底告别图片管理的烦恼～ 🚀