制作我的第一个个人博客——问题与经验


一些体会和血与泪的教训

这是一篇从零搭建个人博客过程中遇到的实际问题与经验总结,内容偏实践,适合参考并按需取舍。

  1. 用户名一致

  2. ssh配置(科学上网)

  3. Hexo 的指令先 clean 再 deploy

    1
    hexo clean && hexo deploy
  4. 下载主题再改yml

  5. 如果配置镜像源,挂梯子都不行,试试不要使用校园网(inhuman 太阴了),用热点试试

网络环境很关键:校园网可能屏蔽或限速部分源与端口,优先尝试移动热点或更换镜像源。

  1. Trae 挺好用的,推荐(很多文件甚至报错的 problems 可以直接导入对话,很方便)

善用 IDE 与 AI 助手加速定位问题,并保持最小化修改验证。

  1. 享受在调 AI 的时候不断出现问题,然后 CSDN 搜索解决,同时弹出新的问题的过程 /doge

调试的快乐

  1. 没下载 nvm 的先别下了(因为要删除现有 npm 所有版本和路径,而且现阶段目前用不到很多版本),shi 山代码的根基不要随意动(例如:Hexo 的功能会失效,需要删除部分文件重新初始化)

工具链变更要谨慎:涉及 Node/npm 的全局版本切换会影响 Hexo 插件解析与主题构建。

  1. 不要试图搞账密系统(GitHub 托管只支持静态网页,在线认证需要第三方托管,成本较高)
Hexo 指令手册

赏
  目录