引言:为什么要解决图片失效问题
做技术笔记时,你是否遇到过这种情况:
- 用 Obsidian 写了半年的知识库,换电脑时发现所有图片都变成了'破碎图标';
- 把 Markdown 笔记分享给同事,对方打开后图片全是本地路径,根本看不到内容;
- 尝试用云盘链接替代,却因为防盗链或链接过期,图片还是无法正常显示……
本地 Markdown 笔记的图片依赖本地路径,是困扰无数创作者的痛点。解决这个问题的核心,就是搭建一个图床——把图片托管到云端,让链接永远有效。
本文将带你用 Gitee(国内免费仓库)+ PicGo(自动上传工具)+ Node.js(运行环境)搭建图床,不仅解决图片失效,还能实现国内访问快、完全免费、无缝对接 Obsidian。从工具原理解析到实操配置,帮你避开常见坑点。
一、概念扫盲:为什么需要这些工具?
在开始操作前,先搞懂四个核心概念,避免盲目操作。
1. 图床:图片的云端仓库
定义:专门用来存储图片的云端平台,核心是生成永久可访问的图片 URL(如 https://gitee.com/xxx.png)。
解决的痛:本地笔记里的 ,换电脑、分享给别人时,链接必然失效;而图床的链接是云端地址,在哪台设备打开都能访问,彻底摆脱路径依赖。
2. Gitee:国内版代码托管平台
为什么选 Gitee 当图床?
- 访问快:国内节点,不用科学上网,图片加载秒开;
- 免费开源:创建开源仓库后,图片可被公开访问(非开源仓库的图片无法外链);
- 支持 RAW 链接:仓库里的图片能通过
https://gitee.com/用户名/仓库名/raw/分支/图片路径.png直接访问,完美适配 Markdown 语法。
3. PicGo:图片上传自动化神器
核心价值:把登录 Gitee、找仓库、点击上传、复制链接的繁琐步骤,压缩成拖入图片后自动生成网络链接,甚至支持快捷键 Ctrl+Alt+U。
为什么需要插件? PicGo 默认支持 GitHub、七牛云等图床,但不直接支持 Gitee。这时需要安装 gitee-uploader 插件,让 PicGo 能对接 Gitee。
4. Node.js:插件的动力引擎
作用:PicGo 的插件是用 Node.js 开发的,必须安装 Node.js 才能运行这些插件。简单说,Node.js 是插件的发动机,没有它,PicGo 无法加载 Gitee 插件。
二、环境搭建:Node.js 安装
1. 下载 Node.js
访问 Node.js 官网,选择 LTS 长期支持版(如 18.18.0 LTS):
- Windows 用户选 x64 Installer(64 位系统通用);
- macOS 选 .pkg 安装包;
- Linux 通过包管理器安装(如
sudo apt install nodejs)。
2. 安装与验证
以 Windows 为例,双击安装包,勾选 Add to PATH(自动配置环境变量),一路点击 Next 即可。
打开命令提示符(CMD),输入以下命令验证:
node -v
npm -v
若正常输出版本号(如 v18.18.0),说明安装成功。国内下载速度可能较慢,如果遇到问题可以寻找镜像源加速。
三、PicGo 安装:图片上传客户端
1. 下载对应版本
访问 PicGo 官网,根据系统选择:
- Windows:优先选 PicGo-Setup-xxx-x64.exe(64 位系统专属);


