JavaScriptNode.js
Gitee+PicGo 搭建 Markdown 笔记图床指南
介绍如何使用 Gitee、PicGo 和 Node.js 搭建图床，解决 Markdown 笔记中图片本地路径失效的问题。内容涵盖环境安装、仓库创建、Token 获取、插件配置及 Obsidian 集成，帮助实现图片自动上传至云端，确保跨设备访问稳定。
介绍如何使用 Gitee、PicGo 和 Node.js 搭建图床，解决 Markdown 笔记中图片本地路径失效的问题。内容涵盖环境安装、仓库创建、Token 获取、插件配置及 Obsidian 集成，帮助实现图片自动上传至云端，确保跨设备访问稳定。
你是否遇到过这样的场景：
本地 Markdown 笔记的'图片依赖本地路径'，是困扰无数创作者的痛点。而解决这个问题的核心，就是搭建一个'图床'——把图片托管到云端，让链接永远有效。
本文将带你用'Gitee（国内免费仓库）+ PicGo（自动上传工具）+ Node.js（运行环境）'搭建图床，不仅解决'图片失效'，还能实现：
从工具原理解析到 Step by Step 实操（包括环境搭建、插件配置、异常排查），甚至帮你避过 90% 的踩坑点。无论你是笔记爱好者，还是专业创作者，都能通过这篇文章彻底解决'图片链接失效'的心病。
在开始操作前，先搞懂四个核心概念，避免'盲目操作'：
https://gitee.com/xxx.png）。，换电脑、分享给别人时，链接必然失效；https://gitee.com/用户名/仓库名/raw/分支/图片路径.png 直接访问（类似 GitHub 的 RAW 链接，但速度更快）。Ctrl+Alt+U）。gitee-uploader 插件（用 Node.js 开发），让 PicGo 能对接 Gitee。gitee-uploader）是用 Node.js 开发的，必须安装 Node.js 才能运行这些插件。简单说：Node.js 是'插件的发动机'，没有它，PicGo 无法加载 Gitee 插件。访问 Node.js 官网，选择 LTS 长期支持版（如 18.18.0 LTS）：
x64 Installer（64 位系统通用）；.pkg 安装包；sudo apt install nodejs）。打开命令提示符（CMD），输入以下命令验证：
node -v
# 输出 Node 版本（如 v18.18.0）
npm -v
# 输出 npm 版本（如 9.8.1）
✅ 若正常输出版本，说明安装成功。
访问 PicGo 官网 或国内镜像，根据系统选择：
PicGo-Setup-xxx-x64.exe（64 位系统专属，性能更优）；PicGo-xxx.dmg；PicGo-xxx.AppImage。Windows 一般建议选 2.4 的版本都是可以的，不要选 2.3 之前的老版本就行，因为老版本还不支持 gitee 插件。
注意这里可能会有一个小插曲——程序被报错不安全，这里直接选保留就行了。
启动 PicGo 后，右下角托盘会出现图标，右键→'打开主界面'即可操作。
img 或者 picture；初始化仓库：勾选（自动生成 README，便于管理）；
登录 Gitee 官网，点击右上角'+'→新建仓库；
点击 Gitee 头像→'设置'→'私人令牌'→'生成新令牌'；
PicGo 图床（方便记忆）；提交后，复制生成的 Token（仅显示一次，务必保存到记事本！）。
命令行手动安装：
npm install picgo-plugin-gitee-uploader -g
先换国内 npm 源（加速下载）：
npm config set registry https://registry.npmmirror.com
搜索框输入 gitee，找到 gitee-uploader 1.1.2 插件，点击'安装'。
⚠️ 若安装失败：请检查 Node.js 环境及网络。
点击'设为默认图床'→'确定'，完成配置。
填写关键参数（参考示例）：
| 参数 | 填写规则 | 示例 |
|---|---|---|
| repo | 用户名/仓库名（从 Gitee 仓库 URL 提取） | your_gitee_name/note-img-bed |
| branch | 仓库分支（可不写，默认 main 或 master） | master |
| token | 刚才复制的 Gitee Token | xxxxxxxxxxxxx |
| path | 图片存储路径（与仓库 img 文件夹一致） | img/ |
| customPath | 按日期分类（可选，如${year}/${month}/${day}） | 2025/09/16（自动生成） |
回到 PicGo 主界面→'图床设置'→选择'Gitee'；
搜索 Image Auto Upload，点击'安装'→'启用'。
打开 Obsidian→'设置'→'社区插件'→'浏览'；
端口：默认 36677, 上传接口默认为 http://127.0.0.1:36677/upload
若被占用，可在 PicGo→'设置'→'设置 Server'中修改。
![[pic.png]] 语法）；https://gitee.com/xxx/xxx.png）；验证：复制链接到浏览器，若能正常显示图片，则配置成功。
node -v 验证，若未安装则回到步骤二。repo 是否为 用户名/仓库名，path 是否与仓库 img 文件夹一致；projects 权限；path 和仓库实际文件夹是否一致（如 img/ 是否存在）。36678），并同步更新 Obsidian 插件配置。通过 Gitee（存储）+ PicGo（上传）+ Node.js（环境）的组合，我们实现了：
附录：工具速链
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online