【2026最新】PicGo 使用教程：从入门到精通

PicGo是一款开源图片上传工具支持多种图床把本地图片传到云端并生成可引用的链接。适合 Markdown 写作者、博客作者和技术文档编写者。适合人群读完你能做到需要写文配图、又不想手动传图的人选图床、配好 PicGo、与 Typora 联动、排查常见问题目录一分钟速览准备工作选图床安装与初次配置常用图床配置Typora 联动进阶功能常见问题与避坑总结与推荐方案一分钟速览按这个顺序做最快上手选图床→ 见下文对比表个人博客常用 GitHub jsDelivr。装 PicGo→ 官网或 GitHub Release 下载对应系统安装包安装后打开。在 PicGo 里配好图床仓库名、Token、分支、自定义域名等。先让 PicGo 在后台运行再在 Typora 里设「上传图片」并验证。编辑时粘贴图片应自动变成https://链接。准备工作选图床常见图床对比图床类型优点缺点适用场景GitHub全球访问较稳国内可能偏慢国际博客、技术文档Gitee国内访问快防盗链需注意国内博客、论坛阿里云 OSS快、稳通常需付费商业、高流量腾讯云 COS国内加速、有免费额度超额需付费中小型项目SM.MS免费、配置简单有流量限制个人笔记、学习注册与准备根据所选服务注册账号并创建公开仓库或存储空间OSS/COS 还需 AccessKey 等见各小节。安装与初次配置下载安装访问 PicGo 官网 或 GitHub 发布页 下载对应系统安装包。按向导完成安装首次打开 PicGo。界面里三块最重要区域作用图床设置选择并配置默认图床插件设置安装图床或功能插件设置重命名、压缩、代理等行为常用图床配置GitHub 图床准备工作注册 GitHub创建公开仓库例如image-bed。生成Personal Access TokenSettings→Developer settings→Personal access tokens勾选repo生成并保存 Token。PicGo 中填写示例项说明仓库名用户名/仓库名分支名main或masterToken上一步生成的 PAT存储路径如images/可选便于分类自定义域名https://cdn.jsdelivr.net/gh/用户名/仓库名分支名Gitee 图床准备工作注册 Gitee创建公开仓库。生成私人令牌设置→安全设置→私人令牌勾选projects。PicGo 中填写示例项说明仓库名用户名/仓库名分支名master或mainToken私人令牌存储路径如images/自定义域名https://gitee.com/用户名/仓库名/raw/分支名阿里云 OSS准备工作注册阿里云开通OSS创建Bucket。在控制台AccessKey 管理创建子用户并授予OSS相关权限记下 AccessKey ID / Secret。PicGo 中填写示例项说明AccessKey ID你的 IDAccessKey Secret你的 Secret存储空间名Bucket 名称存储区域如oss-cn-beijing存储路径如images/自定义域名若已绑定域名填你的访问域名按控制台说明SM.MS按 PicGo 内置或插件说明填写即可一般步骤最少适合快速试用注意流量限制。Typora 联动设置步骤打开Typora→文件→偏好设置→图像。插入图片时选「上传图片」。上传服务选「PicGo (app)」。PicGo 路径指向本机PicGo.exe或 macOS/Linux 可执行文件的安装位置。验证点击验证图片上传选项。若提示成功说明 Typora 能找到 PicGo。注意验证或上传前请先启动 PicGo 并保持后台运行否则可能报「未找到 PicGo」。日常使用在 Typora 中编辑文档。复制本地图片在文档中粘贴CtrlV。PicGo 自动上传并在文中插入https 链接。进阶功能插件在插件设置中搜索安装安装后重启 PicGo。常见示例插件用途gitee-uploaderGitee 图床github-uploaderGitHub 图床qiniu-uploader七牛云picgo-plugin-compress压缩picgo-plugin-watermark水印自定义规则设置里上传前是否压缩、重命名规则时间戳 / UUID 等、上传成功提示、代理网络异常时有用。命令行picgo upload图片路径需已配置好命令行环境具体以官方文档为准。常见问题与避坑现象与处理FAQ现象可能原因处理插入仍是D:/xxx.png本地路径旧文或曾错误配置删图重贴或用 Typora「上传本地图片」上传成功但博客 403/404自定义域名或 raw 路径不对核对 PicGo 里自定义域名格式Typora 验证失败 / 找不到 PicGoPicGo 未运行先打开 PicGo 再验证避坑要点Gitee 防盗链默认链接可能不适合直接嵌图务必配置自定义域名格式形如https://gitee.com/用户名/仓库名/raw/分支名。同名覆盖在设置中开启上传前重命名时间戳或 UUID。权限GitHub Token 需repoGitee 令牌需projects阿里云子用户需OSS权限。总结与推荐方案配置要点 checklist 按需求选好图床见对比表。Token / AccessKey 权限配全。Gitee 等需正确配置自定义域名。使用 Typora 联动时PicGo 保持运行。方案参考场景建议个人博客GitHub jsDelivr CDN国内访问为主Gitee注意防盗链或阿里云 OSS商业 / 稳定付费阿里云 OSS 或腾讯云 COS最佳实践统一图片命名规则配合 PicGo 重命名。定期备份图床仓库或重要资源。可配置多个图床作备用。需要省空间时开启压缩类插件。延伸阅读PicGo 官方文档GitHub 文档仓库与 TokenGitee 帮助中心配置好图床后写作时基本可以「粘贴即上传」把精力放在内容上即可。Happy Blogging!