前言：我为什么要折腾这套方案
之前我用的 CSDN 编辑器写技术文章，每次插入图片都要经历一套"魔幻操作"：
- 上传图片时：必须关闭梯子，不然图片传不上去
- 截图 GitHub 代码时：又得开梯子，不然 GitHub 打不开
- 来回切换：写一篇文章，梯子开开关关十几次，心态崩了
后来我决定：直接在本地 VSCode 写 Markdown，配置一套图床方案。这样文件保存在本地，vscode里轻便又放心
配置完之后之后是怎么样的呢？
直接上结果：
1.比如说这就是你想要截的图片 然后你用快捷键截图
2.截完图自动出现这个编辑界面 你想画箭头 写文字呀都是可以的
3.然后光标放到你想要插入图片的位置 按下 Ctrl+Alt+U 就可以了
4.自动生成了对应的图片在网上的链接 在右边也可以显示出来 复制你的文章全网支持md格式的都能显示了 然后微信公众号的话单独用mdnice转一下 就非常的方便 而且本地同时免费的 github的图片经过jsDeliver加速 国内各大平台访问都很快
✅下面直接上保姆级教程，小白也能 10 分钟配置完成，奥利给！！！（网上有些是2020年的教程 有些网页有点变化 可能不好操作 我这是2026年最新的 看我的就好了哈哈）
一、准备工作
开始之前，你需要：
- ✅ 一个 GitHub 账号（没有的话去 github.com 注册）
- ✅ 已安装 VSCode（去 code.visualstudio.com 下载）
- ✅一个梯子（我试了下啊 上传图片的时候居然开不开梯子都能成功 amazing啊 所以这就是用来让你使用github的 其他没啥用）
二、Step 1：创建 GitHub 图床仓库
1. 登录 GitHub，创建新仓库
点击左侧栏的 new ,新建仓库
2. 填写仓库信息
- Repository name：
image-bed（或picgo-images，随意命名） - Description：
我的图床仓库（可选） - ⚠️ 重要：选择
Public（公开仓库，图片才能被外部访问） - 勾选
Add a README file（可选，建议勾选）
3. 点击 Create repository
创建成功后，你会看到仓库主页。
四、Step 2：生成 GitHub Token（关键步骤）
GitHub Token 是 PicGo 上传图片的"钥匙"，必须正确配置。
1. 进入 GitHub 设置
回到github的主页，点击右上角头像 → Settings
进入 Settings 往下翻
2. 进入开发者设置
拉到最下面，点击 Developer settings（开发者设置）
3. 生成新 Token
进入这个页面
- 点击
Personal access tokens→Tokens (classic) - 点击
Generate new token→Generate new token (classic)
4. 配置 Token 参数
- Note：
PicGo 图床（方便以后识别这个 Token 的用途） - Expiration：
No expiration（永不过期，避免后续失效） - ⚠️ 重要：勾选
repo权限（展开后全部勾选）📸 [配图8：Token 配置页面]
5. 生成并复制 Token
点击页面最下方的 Generate token
⚠️ 立即复制并且保存 Token！ Token 只显示一次，关闭页面后就看不到了。如果忘记复制，只能重新生成。
五、Step 3：安装 VSCode PicGo 插件
1. 打开 VSCode 扩展市场
点击左侧扩展图标（或按 Ctrl+Shift+X）
2. 搜索并安装 PicGo
- 搜索框输入：
PicGo - 找到 PicGo（作者：Spades），点击
Install
六、Step 4：配置截图工具 ShareX（如果你有好用的可以跳过这章直接看下面picgo配置）
之前我是用那个自带的截图功能的 还有一个腾讯管家截图 不过那个自带的不能自动跳出编辑页面 腾讯管家的 不能修改命名 常常导致有特殊符号 不能上传图床 就很麻烦
所以我就下了sharex 这里是下载链接 getsharex.com/
我是直接让阶跃星辰帮我下的
psps 这个是真方便呀 我让它下中文版的就下中文版的 然后什么版本的就什么版本的 都不用一个个去找 找什么汉化版的 我之前都快要被国内各种要充会员的网盘 和github全英文的版本弄的烦死了 有这个是真爽呀 直接下载安装 麻麻再也不用担心我下载东西下载疯了哈哈 它已经是我的御用下载师了（doge）
安装后，简单配置一下
- 设置截图后任务
- 点击截图后的任务 我是点击了打开图像编辑器 和图像复制到剪贴板这两个 其他看自己
- 设置快捷键：
- 打开 ShareX →
快捷键设置 - 设置成你自己想要的就行了
七、Step 5：配置 PicGo 插件
1. 打开 VSCode 设置
点击左下角齿轮图标 → Settings(设置)
搜索框输入：picgo bed
2. 选择github图床
找到 Picgo › Pic Bed: Current，下拉选择：github
📸 [配图14：选择 GitHub 图床]
请插入截图：Picgo: Pic Bed 下拉菜单，选择 "github"
3. 配置图床参数
往下滚动，从 Github: Branch 开始填写参数：
Github: Branch【填写分支名】
main
- GitHub 新仓库默认分支是
main - 如果你的仓库是老仓库，可能是
master，根据实际情况填写
Github: Custom Url（自定义域名）【通过这一步启用jsdelivr加速】
模板：https://cdn.jsdelivr.net/gh/你的GitHub用户名/仓库名
- 后面两个换成你自己的用户名和刚刚创建的仓库名
Path（存储路径）
img/
- 图片会存储在仓库的
img/目录下 就是个文件夹名字 随便取 - ⚠️ 注意：末尾要加
/
Repo（仓库名）
你的GitHub用户名/仓库名
- 格式：
用户名/仓库名，中间用/分隔
Token（访问令牌）
粘贴刚才复制的 GitHub Token
- 就是 Step 2 生成的那个 Token
- ⚠️ 注意：Token 不要泄露给别人
继续往下翻一点 找到 Pic Bed:Upload
选择github
（这个作用是与 github current 一致的 都是选择上传哪个图床 大家电脑系统不同 都选一下 保持一致）
八、Step 6：测试上传（验证配置）
配置完成后，我们来测试一下是否成功。
方法 1：从剪贴板上传（最常用）
- 随便截个图（或复制一张图片）
- 在 VSCode 中新建一个
.md文件 - 按快捷键：
Ctrl+Alt+U（Windows）或Cmd+Alt+U（Mac） - 稍等几秒，图片会自动上传并插入 Markdown 链接 并且在右边提示successfully
九、上传失败常见问题
1 排查配置是否正确
按ctrl+shift+p 打开上端命令面板
输入Preference:Open User Settings(JSON) 进入用户settings.json 文件
你刚刚填的东西都在这里有显示了
自己看一下有没有漏或者不是github的
2 看一下自己截图后图片的命名是否有特殊符号
比如<>或者多一个 . 多一个空格 这种图片都是无法解析到网上变成url的 所以失败 你的截图软件不能自定义命名的话就用我上面推荐的ShareX
其他建议
- 不要滥用：gitHub 单个仓库有 1GB 容量限制， 不要上传大量无关图片
- 这做法还是白嫖：白嫖还是不好的 如果你已经是专业的创作者或者是 需要隐私的图片保存可以选择 国内的腾讯云或者七牛云这种 也不贵 一年也就十几块钱
如果这篇教程帮到你，收藏一下下次用到就不会找不到了哦！
遇到问题欢迎评论区留言，我会尽量解答 👇
本文由作者根据实际踩坑经验整理，转载请注明出处。
