坑一：Git 代理导致 clone 失败

现象

1
2
3
git clone https://gitee.com/xxx/yyy.git
fatal: unable to access '...': Failed to connect to gitee.com:443
over proxy 127.0.0.1 after 2036 ms

定位

代理残留在了 Git 全局配置里，但本地那个端口根本没服务在跑：

1
2
3
4
5
git config --global --get https.proxy
# http://127.0.0.1:10808

netstat -ano | grep 10808
# 无输出 = 端口没有监听

解决

1
2
git config --global --unset http.proxy
git config --global --unset https.proxy

坑二：Gitee Pages 下架

网上教程清一色教你”仓库 → 服务 → Gitee Pages → 启动”，但 2025 年 10 月 11 日这个功能已经下架（官方 issue #ID1EVM 确认）。

替代方案

  • Vercel
  • Cloudflare Pages
  • 腾讯云 EdgeOne Pages

坑三：改完主题没生效

Hexo 有缓存。改完配置必须：

1
hexo clean && hexo generate && hexo server

少了 clean，一半的改动都不会生效。

心得

遇到问题先看报错信息本身，它通常已经把原因说清楚了。别急着搜，先读懂。