前言

2022.04.05更新 picgo是一款开源的图片上传软件，专门负责连通客户与其存储图片的服务器，不过可惜的是picgo的稳定性并不是很强，配置过程中也有很多坑和奇怪的错误，这篇文章分享一下我的配置经验，给想要配的人一个参考。

结合这篇文章，完整的配置流程一般1个小时可以配置完成。

警告

20230212：不知道因为什么原因，防火墙似乎有变动，会导致PICGO的日志中显示Git和PicGo等软件无法链接GitHub，造成各种因为链接不通畅而产生的错误，解决方法如下：

1. 访问IPaddress (opens new window)查询ip

2. 把140.82.112.4 github.com字段添加进电脑的Host文件，即可正常使用

首先安装软件，软件下载地址 (opens new window)，下载后直接安装即可，没有需要特别注意的点，默认路径即可。

教程PICGO版本：2.4.0 beta6

配置教程

预准备

安装完软件后建议先先安装picgo-plugin-github-plus插件

这个插件非常好用，可以实现双向同步GitHub仓库的图片，而软件自带的GITHUB的只能存图不能删图，删除图片流程会很麻烦。

安装方法:

1. 在软件界面左边点击插件设置，并在搜索框搜索github

   

2. 使用git bash客户端输入npm代码安装，npm的来源根据自己网络情况而定

npm install --location=global picgo-plugin-github-plus
#为了实现全局安装，最新版的npm已经不推荐使用-g或-global了，建议使用--location=global。

安装完成后即可在picgo里找到github plus插件

如果没有显示，则在picgo设置里找到并勾选,就会显示在图床设置中了

图床配置

点开图床设置，可以看到依次有六个选项

Repo

repo是repository的缩写也就是仓库路径,首先是要去GitHub建立一个仓库

记得一定要选择public选项, 不然没法使用里面的图片

(所以这意味着所有图片别人都可以从你的仓库访问, 一定要注意上传的图片的脱敏性, 预防隐私泄露)

新建好仓库后repo这一栏填写 "你的Github Id"/"仓库名" 即可

Branch

注意:这里再2020年之后就必须填成main, 因为GitHub把默认分支名字改了(因为master这个名字被网友喷了，说有种族歧视的意味)

Token

这个是重点，目的是让PICGO能与Github完成信息确认与身份验证，避免其他人在得知你的仓库地址后乱传东西进取。操作方法如下：

1. 到GitHub设置里，点击头像找到setting

2. 左侧往下找到开发者设置

3. 自己新建一个token密钥

几个关键的注意点：

1. 名字随便取，但尽量可以让自己以后看到了也知道这个token是干什么用的
2. 如果没有特殊要求，有效期选择无限时长即可
3. 下方需要勾选token的权限范围。picgo只需要勾选repo相关选项即可
4. 完成选项的填写与勾选后，点击该页面最下方generate token即可生成
5. 生成的TOKEN代码只会在本次的页面显示，刷新页面、重新加载后就会永久隐藏。也是为了保障token的安全，所以最好备份好(可在配置好的图床json文件中找到，详细路径请看文末), 否则只能再建一个token

Path

这个是存照片的路径，是用来指定仓库中的存储路径的，这里有个报错天坑，网上没什么人提到，就是一定要事前通过Git把要的文件夹创建好，否则软件识别不到路径就报错了，(且文件夹还不能是空的, GitHub空文件夹=不存在,赛个txt也好)，因此如果嫌麻烦可以空着，这样所有的照片都会出现在仓库的根目录，其实也不影响使用。

具体教程参考这篇文章Git版本管理软件使用心得 - Tommy's Blog (tommyzeng.com) (opens new window)

当建好后img文件夹后, 就可以写上,这样才能上传成功,否则一直报错,PicGo没权限建文件夹

反正原版GitHub插件不可以，这个plus插件理论上权限更多，还没测试这样会不会报错，反正多做一步省得报错

img/

CustomUrl

这个是自定义图片的呈现连接，可以通过这个功能接入第三方的CDN加速（CDN可以理解为一个提高访问速度的高速缓存服务，因为github的服务器国内很难直接访问，可能会导致图片无法显示或者很长时间才能加载出来）推荐使用jsdelivr的CDN服务加速，最大的优点就是免费，配置非常简单，就能大幅提高图片的访问速度

不过Jsdelivr的服务有很多提供商，域名也大同小异，且不一定是每个都能用，这篇文章列举了各个服务商的可用域名，且提供了测试可否使用的测试链接，详情见：图床CDN可用JsDelivr配置更新

配置方法：

https://gcore.jsdelivr.net/gh/"你的GitHubid"/"仓库名字"

Origin

选择你的图床平台即可, 这里不推荐使用gitee作为图床,gitee个人版不能上传1mb以上的图片,这平台实在是有点坑

插件安装

这里推荐两个软件，github插件前面推荐过了，compress这个软件可以高质量的压缩图片，提高访问速度且不会太影响画质

app内安装插件可能会卡在安装中，一直装不好，建议使用npm指令安装

picgo-plugin-github-plus Github插件

cnpm install picgo-plugin-github-plus --location=global --registry=https://registry.npm.taobao.org

picgo-plugin-compress图片压缩插件

cnpm install picgo-plugin-compress --location=global --registry=https://registry.npm.taobao.org

使用教程

这部分是讲怎么区分到底上传没上传成功，这是这个软件不是很友好的一个点，很多问题导致的上传失败表现的不明显。在GitHub Plus插件中，甚至完全没有提醒，直接进度条突然间跑完了，然后啥也没出现。

总之，检验上传成功与否，最好的办法就是在上传完成后，在相册这一个窗口内出现了刚才上传的这个照片，就算成功，如果这里过了一会啥也没有，通常就是上传失败了。

这里补充一下，github plus这个插件不受软件代理设置的影响，如果出现了网络问题导致的上传失败可以尝试在设置中配置科学上网信息，但通常只有软件自带的上传模块能正确代理，而插件则没办法绕过。之前网络问题导致过一段时间的这种情况的发生。

推荐设置

常规设置

推荐把更新助手关了,这个貌似会重置配置文件, 导致突然自己的配置文件没了

时间戳重命名推荐打开, 因为时间久了不可避免会有名字重复的图片,这样子引用图片会出bug

自启开着无妨,速度也不会被拖慢

往下滑动有个上传后自动复制url的功能也推荐打开, 非常实用

修改快捷键自己可以设置一个, 很多人第一次可能不懂这个快捷键怎么用,确实有点阴间,这个是上传剪贴板内的图片的,当图片位于剪贴板第一位时按下即可上传并自动复制url

配置文件路径

完成所有的陪之后，在以下路径即可找到完整的配置文件，该文件可以保存好，如果以后软件重装或者配置文件丢失，都可以通过这个文件快速替换恢复

C:\Users\'你的用户名'\AppData\Roaming\picgo

找到文件名叫data.json就是配置文件,建议自己设置好设置后复制一份放好, 实测picgo有时会莫名其妙重置图床设置

排障方法

Picgo根据我这一年多的使用总结，发现还是偶尔会遇到抽风的问题，这里教大家怎么样识别具体的故障原因。

1. 点击打开Picgo的设置，并找到第三个选项设置日志文件并点击打开，会弹出一个窗口
2. 在窗口中可直接点击按钮打开，此事会弹出一个记事本文件，里面会用时间戳的形式一行一行详细的记录软件各种操作执行的情况，如果报错，也会提示具体的报错代码。在报错的情况下，可以尝试把对应时间戳的信息复制到百度中查询，如果是特定时间段内统一出现的问题，那网上大概率可以找到很多问题解决的帖子，而且根据经验，绝大多数问题都是网络问题导致的。
3. 新版本的picgo增加了上传提示的系统提醒，可以开着这个，这样报错了可能会有相应弹窗。