之前的文章里面讲了Hexo + GitHub Pages 零基础搭建博客详细步骤,接下来这篇文章将讲解一下怎么怎么在 GitHub 上托管技术博客,这里主要介绍的是Windows系统上面的操作。

一、本地写技术博客文章

1. 打开终端(Windows/Mac 操作不同,分开讲)
  • Windows 用户:按下Win键(或者Win+R快捷键打开)→ 搜索 “命令提示符”(或 “CMD”)→ 点击打开(如果之前部署时用了管理员身份,这里也建议用管理员身份打开,避免权限问题)。
  • Mac 用户:打开 “启动台”→ 找到 “终端”(Terminal)→ 点击打开。
2. 切换到你的 Hexo 项目文件夹(核心:终端必须在 Hexo 路径下执行命令)

假设你的 Hexo 项目文件夹在 E盘的HexoBlog文件夹(我之前的路径是E:\HexoBlog),在终端里执行以下命令:

# 第一步:切换到E盘(Windows需要先切盘,Mac不需要这一步)
E:

# 第二步:进入Hexo项目文件夹(把HexoBlog换成你的实际文件夹名)
cd HexoBlog

成功标志:终端提示符会变成 E:\HexoBlog>(Windows)或 你的电脑名:HexoBlog 你的用户名$(Mac),说明已经进入 Hexo 项目路径。

常见问题:如果显示 “系统找不到指定的路径”→ 检查文件夹路径是否正确(比如是不是把 “HexoBlog” 写成了 “hexoblog”,Windows 路径区分大小写)。

3. 新建一篇技术博客文章

在终端执行以下命令(把"Python装饰器的底层原理"换成你想写的文章标题):

hexo new "Python装饰器的底层原理"

执行后终端会显示:INFO Created: E:\HexoBlog\source\_posts\Python装饰器的底层原理.md,说明文章已经生成。

作用:Hexo 会自动在source/_posts文件夹里创建一个 Markdown 格式的文章文件(.md 后缀),后续只需要编辑这个文件即可。

4. 用 VS Code 打开并编辑文章
  • 打开 VS Code 软件→ 点击左侧 “资源管理器”→ 点击 “打开文件夹”→ 选择你的 Hexo 项目文件夹(比如E:\HexoBlog)→ 确认打开。

  • 在 VS Code 的左侧文件列表中,找到 source 文件夹→ 展开后找到 _posts 文件夹→ 点击里面的 Python装饰器的底层原理.md 文件,就能开始编辑了。

编辑示例(Markdown 语法,直接复制到文件里就能看到效果)

# Python装饰器的底层原理
今天详解Python装饰器的实现逻辑,从语法糖到函数本质~

## 一、装饰器的作用
装饰器可以在不修改原函数代码的前提下,给函数添加额外功能(比如日志、计时)。

## 二、基础代码示例
```python
# 定义一个计时装饰器
import time
def timer(func):
    def wrapper(*args, **kwargs):
        start = time.time()
        result = func(*args, **kwargs)
        end = time.time()
        print(f"函数执行耗时:{end - start}秒")
        return result
    return wrapper

# 用装饰器装饰目标函数
@timer
def add(a, b):
    return a + b

# 调用函数,会自动触发装饰器的计时功能
print(add(1, 2))  # 输出:函数执行耗时:xxx秒  3

将上面的代码复制到.md文件里面之后可以点击右上角的预览符号查看效果。

三、底层原理:函数是一等对象

Python 中函数可以作为参数传递、作为返回值,装饰器就是利用了这个特性...

作用:Markdown是轻量级编辑语法,支持标题、代码块、列表等,写完后Hexo会自动把它转换成网页格式。


### 二、生成博客静态文件(把Markdown转成浏览器能打开的网页)
文章编辑完成后,回到终端(确保终端还在Hexo项目路径下),执行以下命令:
hexo generate
# 也可以简写为:hexo g

执行后终端会显示类似 INFO Generated: public/xxx.html 的内容,说明静态文件生成完成。作用:Markdown 文件是纯文本,浏览器无法直接显示,hexo generate 会把所有 Markdown 文章、博客样式等,转换成浏览器能识别的 HTML(网页)、CSS(样式)、JS(交互)文件,这些文件都存在 Hexo 项目的 public 文件夹里。

三、把静态文件推到 GitHub 专属仓库(让博客上线)

在终端执行组合命令(这条命令包含 “清理旧文件 + 生成新文件 + 推送到 GitHub” 三个操作):

hexo clean && hexo generate && hexo deploy
# 也可以简写为:hexo c && hexo g && hexo d
命令拆解说明:
  • hexo clean:清理之前生成的旧静态文件(避免缓存导致新内容不显示);
  • hexo generate:重新生成最新的静态文件;
  • hexo deploy:把public文件夹里的静态文件,自动推送到你的用户名.github.io仓库的gh-pages分支。

成功标志:终端最后一行显示 INFO Deploy done: git,说明推送成功。

常见问题:如果显示 “Permission denied”→ 检查 SSH 密钥是否加载(Windows 重新执行ssh-add 你的私钥路径);如果显示 “Repository not found”→ 检查_config.yml里的仓库地址是否正确。

四、访问你的技术博客

  1. 等待 1-5 分钟(GitHub 需要同步仓库里的新文件,非首次部署会更快);
  2. 打开任意浏览器,在地址栏输入你的博客地址(把HappyBoy-Mr-Che换成你的 GitHub 用户名):
    https://HappyBoy-Mr-Che.github.io
    
  3. 按下回车,就能看到刚写的技术博客文章啦!
Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐