必须组合使用picgo与markdown image等捕获类插件：picgo负责图床通信，markdown image负责捕获图片并调用上传；关键配置字段为repo、token和customurl，填错customurl最易导致图片上传成功却无法显示。
装哪几个插件才真正管用
只装 PicGo 或只装 Markdown All in One 都没法自动上传图片。必须组合使用，且角色不能颠倒：PicGo 负责上传逻辑和图床通信，Markdown Image 或 Paste Image 这类插件负责捕获图片并调用上传流程。
推荐最小可行组合：
-
Markdown Image：轻量、专注图片上传，快捷键Ctrl+Alt+U（Win/Linux）或Cmd+Alt+U（macOS）直接粘贴剪贴板图片 -
PicGo：作为后端服务，支持 Gitee、GitHub、SM.MS 等图床，配置写在用户设置里，不随项目变动 -
Markdown Preview Enhanced：不是必须，但若需 mermaid 图表、数学公式或导出 PDF，它比自带预览强得多
别装 Upload Image 和 PicGo 同时启用——两者都监听剪贴板，容易冲突导致上传失败或重复插入链接。
PicGo 配置必须填对的三个字段
在 VSCode 设置中搜索 PicGo，打开 picgo.customConfigPath 对应的 JSON 文件（通常是 ~/.picgo/config.json），关键字段只有三个真正影响上传成败：
-
"repo"：格式必须是"用户名/仓库名"，不能带https://前缀，也不能含空格（空格会被转成-，导致 404） -
"token"：Gitee 的 Personal Access Token，权限至少勾选projects；GitHub 的 token 则需public_repo -
"customUrl"：这是生成后插入 Markdown 的链接地址，不是上传地址。Gitee 推荐用"https://gitee.com/用户名/仓库名/raw/main/"；GitHub 若走 jsDelivr 加速，填"https://cdn.jsdelivr.net/gh/用户名/仓库名@main"
填错 customUrl 是最常见问题：图片明明上传成功，但插入的是 raw 链接（国内加载极慢）或拼写错误的路径，结果预览里显示“裂图”。
为什么上传后图片不显示？先查这三处
上传成功但 Markdown 中图片不渲染，往往不是插件问题，而是环境链路断在中间：
- 检查 Gitee/GitHub 仓库是否为 公开（Public）：私有仓库的 raw 链接无法被外部访问，
customUrl指向私有库就必然 404 - 确认图片文件名不含中文或特殊字符：如
截图_2026-06-24(1).png在部分图床会上传失败，建议插件设置里开启"nameFormat"自动转为英文时间戳 - VSCode 编辑器右下角状态栏查看
PicGo是否显示 “Ready”：若显示 “Error” 或长时间卡在 “Uploading”，说明 token 过期或网络代理干扰（尤其是开了 Clash/Shadowrocket 时，PicGo 默认不走系统代理）
如果用 Gitee，还可能遇到 hosts 劫持问题：部分宽带运营商会劫持 gitee.com 域名，导致上传请求超时。临时解决可在 C:\Windows\System32\drivers\etc\hosts（Win）或 /etc/hosts（macOS/Linux）里加一行 114.114.114.114 gitee.com。
不同图床的上传速度与稳定性差异
图床选型直接影响写作节奏，不是越知名越好：
-
Gitee：国内直连，上传 200KB 以内图片基本 -
GitHub + jsDelivr：CDN 加速后访问快，但上传本身受 GitHub API 限流（每小时 5000 次），且 token 权限配置稍复杂；适合长期稳定项目，不适合高频截图场景 -
SM.MS：免登录、API 简单，但免费版限 100 次/天，且无自定义域名，链接易失效；仅建议临时应急用
真正影响体验的不是“能不能传”，而是“传完能不能立刻看到”。Gitee 的 raw 链接虽不如 CDN 快，但胜在确定性——你不需要猜它今天抽不抽风。
