配置步驟
詳細配置指南
1. 軟件準備
- 安裝Typora:官方下載鏈接
- 安裝PicGo:GitHub下載鏈接
- 注冊Gitee賬號:Gitee官網
2. Gitee倉庫配置
- 登錄Gitee后創建新倉庫(如
pik-bed
)- 訪問:創建新倉庫
- 確保倉庫設置為"公開"(極其重要)
- 點擊"管理" → “倉庫設置” → 倉庫類型選擇"公開"
- 創建Token
- 訪問:個人訪問令牌
右上角頭像==》設置==》私人令牌 - 創建新Token,確保勾選"projects"權限
- 訪問:個人訪問令牌
3. PicGo配置
-
安裝Gitee插件
- 打開PicGo → 插件設置 → 搜索"gitee" → 安裝"gitee-uploader"
- 插件鏈接:picgo-plugin-gitee-uploader
-
配置Gitee圖床
- 圖床設置 → Gitee圖床
- 填寫以下信息:
owner: 你的Gitee用戶名(如zhou-zhou110) repo: 倉庫名(如pik-bed) branch: master token: 步驟2創建的Token path: img/{y}{m}{d} (添加時間戳防止文件重名) customUrl: https://gitee.com/你的用戶名/倉庫名/raw/master
-
啟用時間戳
4. Typora配置
- 打開Typora → 文件 → 偏好設置 → 圖像
- 上傳服務設定為"PicGo(app)"
- PicGo路徑指向你的PicGo安裝位置(如
D:\Program Files\PicGo\PicGo.exe
) - 點擊"驗證圖片上傳選項"測試配置
5. 常見問題排查
上傳失敗錯誤:
- “更新失敗”(錯誤400):檢查圖片是否已存在,或token權限是否足夠
- “Access denied”:確認倉庫已設為公開,且分支名稱正確
- 圖片上傳成功但顯示不出:檢查Typora生成的鏈接是否正確,可能需要手動修復鏈接格式
- PicGo未生成正確時間戳:確認path格式正確,重啟PicGo嘗試
- PicGo日志位置:
C:\Users\用戶名\AppData\Roaming\picgo\picgo.log
圖片URL格式:
正確的URL應該是:
https://gitee.com/用戶名/倉庫名/raw/master/img/年月日/圖片名.png
最好不打開typora的圖片自動上傳,使用手動全部上傳
6. 最佳實踐
- 使用時間戳格式避免文件名沖突
- 定期清理不再使用的圖片:Gitee文件管理
- 備份重要的Markdown文檔和圖片
- 在上傳前壓縮圖片,避免超過Gitee限制(單文件通常限制為50MB)
- 參考PicGo官方問題排查:常見問題
7. 其他備選圖床
如Gitee出現問題,可考慮以下替代方案:
- GitHub + PicGo-GitHub插件
- 七牛云 + PicGo-七牛插件
- 騰訊云COS + PicGo-騰訊COS插件
按照以上步驟配置后,你就可以在Typora中直接粘貼圖片,它們會自動上傳到Gitee并插入正確的鏈接格式。