使用Hexo+gitHub搭建你的个人博客

本文详细介绍如何使用Hexo在本地搭建个人博客,包括环境配置、主题安装与使用,以及如何将博客部署到GitHub上。

从开始工作到现在,大大小小做了不少项目,经验也算是积累了一点,期间也遇到了不少的坑,所以最近想自己搭建一个博客,把自己遇到的坑和总结的经验记录在上面,并将自己以前在博客园,简书等写的文章迁移过来,也希望可以帮到更多的小伙伴。

在本地搭建hexo博客

环境搭建

首先我们需要安装node,npm,git,安装方法这里就不在说了,自行百度就好。然后我们需要一个github账号,大家可以用邮箱去注册一个,很简单的。

安装hexo

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。

hexo的安装可以参考官网 hexo

如果您的电脑已经安装了node和npm,请打开终端,使用npm全局安装hexo-cli

$ npm install -g hexo-cli

进入电脑D盘或者mac电脑的documents或者随便什么地方,新建一个文件夹hexoBlog,并初始化Hexo

$ mkdir hexoBlog
$ cd hexoBlog
$ hexo init
$ npm install

安装完之后,文件目录应该如下:

.
├── _config.yml       //根网站配置文件,可以在此修改关于网站的大部分配置
├── package.json      //应用程序的信息
├── scaffolds         //模版文件夹
├── source            //资源文件夹,存放用户资源的地方
|   ├── _drafts
|   └── _posts        //博客的文章,默认有hello-world.md
└── themes            //主题文件夹,用于存放主题
|   ├── landscape     //博客默认主题

这样,一个最基础的博客已经安装完成。

运行博客

接下来我们要让博客在浏览器上运行起来。

$ hexo generate

这条命令可以简写成$ hexo g,目的是生成静态文件,将.md转化为html文件,可选参数为

选项描述
-d, --deploy文件生成后立即部署网站
-w, --watch监视文件变动

然后启动一个服务器,默认地址为http://localhost:4000/

$ hexo server

可简写为$ hexo s

然后在浏览器打开http://localhost:4000/ ,就可以看到自己的博客了

使用next主题

如果想美化自己的博客的话,可以选用一些主题,当然你也可以自己开发一个独一无二的博客主题。这里我们采用next主题。next地址
在这个github仓库中我们可以预览下同样使用这个主题的别人的博客样式。

下载next

克隆该主题到博客的themes文件夹下

$ git clone https://github.com/theme-next/hexo-theme-next themes/next

这时的文件目录结构应该为:

.
├── _config.yml       //根网站配置文件,可以在此修改关于网站的大部分配置
├── package.json      //应用程序的信息
├── scaffolds         //模版文件夹
├── source            //资源文件夹,存放用户资源的地方
|   ├── _drafts
|   └── _posts        //博客的文章,默认有hello-world.md
└── themes            //主题文件夹,用于存放主题
|   ├── landscape     //博客默认主题
|   └── next          //next主题
|       ├── ...       //其它文件
|       └── _config.yml   //主题配置文件,可以在此修改关于网站的大部分配

使用next主题

打开网站根目录下面的_config.yml 文件,注意区分主题目录下的_config.yml 文件,搜索theme: landscape,找到这一行,并且将landscape改成next,然后就可以了。

选择next主题的样式

next主题有四种样式可供选择,分别是Muse scheme, Mist scheme,Pisces scheme,Gemini scheme,其具体样式可以在github上找到相应链接去预览下,并选择自己喜欢的。
打开themes/next文件夹下面的_config.yml 文件,注意这里不是根目录下面的,找到scheme: Muse一行,可以通过将Muse改为MistPiscesGemini来使用不同的样式,注意冒号后面的空格一定要有。

启动博客

在Bash依次输入以下命令

$ hexo clean        //删除本地已经生成的所有静态文件 
$ hexo g            //生成静态文件
$ hexo s            //启动服务器后  

然后在浏览器打开http://localhost:4000/ ,就可以看到博客已经穿上新衣服啦

部署到GitHub

建立GitHub仓库

这里使用的是github提供的Gitpage功能
新建一个名字为<你的用户名>.github.io的仓库,注意用户名一定要是自己的用户名,比如我的就是fengkang92.github.io。然后打开Settings ->GitHub Pages

部署

以下方法均需要你已经安装git,并且在本地和github之间配置了公钥。

首先安装hexo-deployer-git

$ npm install hexo-deployer-git --save

然后打开根目录下的_config.yml文件,找到deploy项,并修改为

deploy:
  type: git
  repo:  
    github: git@github.com:<你的用户名>/<你的用户名>.github.io.git
    branch: [branch] #published
    message: [message]
选项描述
repo库(Repository)地址
branch分支名称,默认master
message自定义提交信息

执行如下命令:

hexo clean && hexo deploy

前者清除站点文件,后者重新生成站点文件并将之推送到指定的库,稍等片刻,打开https://<你的用户名>.github.io/

PS:由于刚刚搭建好博客,还没有加入七牛CDN等,所以这篇文章就没有图片了,等我把博客常用的东西都弄好,后续再补充图片啥的吧,哈哈。

<think>好的,我需要帮助用户了解如何用HexoGitHub免费搭建个人博客网站。首先,我得回忆一下Hexo的基本流程和GitHub Pages的使用方法。用户可能对静态网站生成器和版本控制不太熟悉,所以步骤需要详细但简洁。 首先,安装Node.js和Git是前提条件,因为Hexo基于Node.js,而Git用于部署到GitHub。我需要确保用户正确安装这些工具,可能还需要指导他们如何验证安装是否成功。 接下来是安装Hexo,通过npm全局安装。然后初始化项目,进入目录并安装依赖。这里需要注意命令的正确性,比如hexo init之后是否要指定文件夹,或者默认当前目录。 创建GitHub仓库的部分,用户需要知道仓库命名规则,比如username.github.io必须正确,否则无法生成页面。可能需要提醒用户将username替换为自己的GitHub用户名。 配置Hexo的部分,重点是修改_config.yml文件中的部署设置。需要指出正确的仓库URL和分支,通常使用main或master分支。这里容易出错,比如缩进问题或拼写错误,可能需要特别强调语法。 生成静态文件和部署的命令,hexo generate和hexo deploy,用户需要了解每个步骤的作用。可能还要提到hexo server来本地预览,这对调试很重要。 最后,自定义主题和写作的部分,用户可能希望个性化博客,所以需要推荐一些主题和基本的写作流程。比如创建新文章的命令,以及如何修改主题配置。 在引用方面,用户提供的引用链接[^1]和[^2]需要正确对应到相关内容。比如,引用是关于使用HexoGitHub搭建网站的具体指南,而引用[^2]是静态生成器的集合,可能用来推荐其他工具,但当前问题主要关注Hexo,所以可能只在最后提到。 还要考虑用户可能遇到的问题,比如部署失败、页面无法访问、主题安装错误等,是否需要包含常见问题解答?不过根据用户要求,回答应结构清晰,分步骤解决,可能不需要深入排错,但可以建议查阅引用资料获取更多帮助。 最后,生成的相关问题需要围绕HexoGitHub Pages的优化、主题选择、部署问题等,确保问题有针对性,帮助用户进一步探索。</think>### 如何使用HexoGitHub免费搭建个人博客网站? 以下是分步操作指南: #### 1. 环境准备 - **安装Node.js** 访问[Node.js官网](https://nodejs.org/)下载安装包,完成后验证安装: ```bash node -v # 查看Node.js版本 npm -v # 查看npm版本 ``` - **安装Git** 访问[Git官网](https://git-scm.com/)下载安装包,完成后验证: ```bash git --version ``` #### 2. 安装Hexo ```bash npm install -g hexo-cli # 全局安装Hexo脚手架 hexo init myblog # 初始化博客项目 cd myblog npm install # 安装依赖 ``` #### 3. 创建GitHub仓库 - 新建仓库名为 `用户名.github.io`(需替换为你的GitHub用户名) - 仓库需设为公开(Public) - 分支默认使用 `main` 或 `master` #### 4. 配置Hexo部署 修改 `_config.yml` 文件末尾的部署配置: ```yaml deploy: type: git repo: https://github.com/你的用户名/你的用户名.github.io.git branch: main ``` #### 5. 安装部署插件 ```bash npm install hexo-deployer-git --save ``` #### 6. 生成静态文件并部署 ```bash hexo clean # 清理缓存 hexo generate # 生成静态文件 hexo deploy # 部署到GitHub ``` #### 7. 访问博客 打开浏览器输入 `https://你的用户名.github.io`,约1-2分钟后生效。 #### 8. 自定义主题(以Butterfly主题为例) 1. 安装主题: ```bash npm install hexo-theme-butterfly ``` 2. 修改 `_config.yml`: ```yaml theme: butterfly ``` 3. 重新部署: ```bash hexo clean && hexo deploy ``` #### 9. 写作新文章 ```bash hexo new "我的第一篇文章" # 在source/_posts生成Markdown文件 # 编辑完成后重新生成部署 ``` --- ### 关键配置说明 1. **本地预览** 使用 `hexo server` 可在 `http://localhost:4000` 实时调试 2. **自定义域名** 在博客根目录添加 `CNAME` 文件(内容为域名),并在域名服务商处配置DNS解析 3. **自动持续集成** 可通过GitHub Actions实现自动构建(参考[GitHub Pages文档](https://docs.github.com/en/pages)) --- ### 优势分析 | 方案 | 成本 | 技术门槛 | 可定制性 | 维护难度 | |------------|-------|----------|----------|----------| | Hexo+GitHub| 免费 | 中等 | 高 | 低 | | WordPress | 付费 | 低 | 中 | 中 | | Wix | 免费/付费 | 低 | 低 | 低 | --- ### 常见问题处理 - **页面404错误** 检查仓库命名是否正确,部署分支是否匹配 - **样式加载失败** 主题配置后需重新生成静态文件 - **部署超时** 尝试清除浏览器缓存或等待GitHub服务器刷新(最长等待10分钟) ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值