创客空间2025级新生训练营博客搭建赛道

前言

欢迎大家参与创客空间2025级新生训练营的博客搭建赛道！在这个赛道中，你将学习如何使用Hexo和自选主题来搭建一个美观且功能齐全的个人博客。本文将提供详细的步骤指导，帮助你从零开始创建自己的博客。

Q 版 logo.png

想直接看教程的同学可以点传送门进行跳转哦！

评分准则

本赛道总分为100分，分值占比如下表所示：

🎯 项目名	📋 解释	📐 细则
完成度 (40分)	博客基础搭建与部署完成情况	• 成功安装Hexo并初始化博客(20分) • 成功部署到GitHub Pages并能正常访问(20分)
博客DIY创意 (20分)	博客个性化定制与美化程度	• 更换主题并进行基础配置(10分) • 个性化定制(头像、导航、色彩等)(10分)
博文内容 (20分)	博客文章质量与原创性	• 能够展现出自己掌握了markdown语法(5分) • 文章内容质量、外挂标签的使用等(15分)
积极性活跃度 (20分)	参与度与互动表现	• 按时提交博客链接(5分) • 群内互动活跃度(15分)

总计：100分

博客是什么

博客是一个展示你自己的平台，是一个记录你生活的地方，是组建独属于你的小天地的港湾。

展示自己

对于博客这个东西最直观的功能就体现在我们可以把自己做的项目展示在这里，让别人一看就知道你掌握了什么，你经历了什么成长的足迹。这里不仅仅是一个作品集，更是你内心世界的外化表达。每一行代码，每一个设计，每一次思考的火花，都在这里闪闪发光。

当你把自己的第一个项目放上博客的那一刻，那种成就感是无与伦比的——你终于有了一个属于自己的舞台，可以骄傲地说：”看，这就是我创造的！”无论是简单的Hello World，还是复杂的系统架构，它们都承载着你的汗水与梦想。在这个数字化的时代，博客就是你最好的名片，让远方的朋友、未来的同事、甚至是你自己，都能清晰地看到那个不断成长的你。

记录生活的温柔时光

博客更是一个时间胶囊，静静地收藏着你生活中那些闪光的瞬间。也许是深夜coding时突然顿悟的那一刻，也许是和室友一起刷题到天亮的青春岁月，也许是第一次拿到offer时激动得颤抖的手指。

这些看似平凡的日常，在博客的记录下变得珍贵而有意义。多年后当你回过头来翻阅这些文字，你会惊讶地发现，原来自己走过了这么长的路，原来那个曾经迷茫的少年已经成长为今天的自己。每一篇博文都像是写给未来自己的一封信，告诉着那个还在路上的你：”嘿，你看，我们终究是走过来了。”

生活不只有代码和项目，还有那些温暖的人和事。博客让你学会用文字记录感动，用心感受生活的美好。当你开始写博客的那一刻，你就开始学会了观察生活，思考人生，这本身就是一种成长。

独属于你的精神港湾

在这个喧嚣的世界里，每个人都需要一个可以安放灵魂的地方。博客就是这样一个港湾，一个完全属于你的小宇宙。在这里，你可以卸下所有的伪装，做最真实的自己。

这里没有老板的催促，没有ddl的压力，没有别人的指指点点。你可以随心所欲地表达自己的想法，分享自己的见解，甚至是那些看似幼稚但珍贵的梦想。在这个小小的数字空间里，你就是国王，你就是创造者，你就是那个可以决定一切的主人。

当生活给你带来挫折时，博客是你倾诉的树洞；当你取得成就时，博客是你分享喜悦的平台；当你感到孤独时，博客连接着远方那些和你有着相同经历的灵魂。它见证着你的每一次蜕变，陪伴着你走过人生的每一个阶段。

这就是博客的魅力——它不仅仅是一个网站，更是你生命中不可或缺的一部分，是你在这个数字世界中最温暖的家。

在博客DIY的摸爬滚打中成长

在搭建好博客，选择了自己心意的主题后，你就会忍不住的去美化自己的博客，去让自己的博客看起来与众不同，让你的朋友在点进去后不禁赞叹你的博客设计。在这样的正反馈螺旋的推动下，你会渐渐的不满足于主题所提供的配置项，开始自己学习钻研如何进行魔改，在原本的主题基础上进行二次开发，甚至自己动手写一个主题。渐渐的你的博客功能越来越多，文章的内容越来越有深度，连着翻了好几页后还没有翻到头的文章库会让你感恩过去的自己，感谢自己坚持了下来。

上面这张图是我博客网站主题butterfly最初的模样在经过了魔改之后改造成了如今的样子。

这些都是我看过的魔改教程只是很小一部分有用的我收藏了起来，越改就会越发现，到最后就是要自己去改框架才能真正实现自己想要的功能，一味的照搬别人的教程最终只会趋同化，限制住自己的创造力。

以上这些也正是我们创客空间近两年的活动一直都有包含博客搭建这样一个内容。我希望通过这个赛道的学习与实践，你能领悟到博客的真正意义，它能成为你人生中一个宝贵的财富，一个陪伴你走过每一个重要时刻的见证者。

开始你的博客之旅

准备工作

安装Git

Git 是用于管理博客代码版本以及推送博客内容到 GitHub 的重要工具，当然它的用处不止于此，总之程序员必备。Git 官方网站，同样根据操作系统类型下载合适的安装包进行安装。安装完成后，在命令行中输入git --version若显示 Git 的版本信息，则表明安装成功。

1	git --version

安装Node.js

Node.js 是 Hexo 运行所依赖的关键环境。访问 Node.js 官方网站，在首页根据自己的操作系统类型（Windows、Mac OS 或 Linux）选择相应的安装包进行下载。

下载完成后，按照安装向导的提示逐步完成安装。安装结束后，打开命令行工具（在 Windows 上是“命令提示符”或“PowerShell”，在 Mac OS 和 Linux 上是“终端”），安装好之后我们可以输入以下指令如果都能正常输出版本号则安装成功。

1 2	node -v npm -v

注册 GitHub 账号

打开浏览器，访问 GitHub 官网。在首页上找到“Sign up”按钮，点击后按照提示填写相关信息，包括用户名、邮箱地址和密码等，完成注册过程。这个账号将作为存储博客文件的仓库，承载着博客的所有代码和内容。

这一步极大概率要使用科学上网，否则可能会出现无法访问的情况。后续的很多步骤，以及往后的程序员生涯你注定是要使用科学上网的，学会怎么用科学上网也是本训练营的目的之一。

安装Hexo

本级小标题将会占据总评分数中完成度模块中的20分

创建博客目录

在本地计算机的硬盘上，选择一个你方便管理的位置（例如 D 盘根目录或者用户目录下的某个文件夹），创建一个新的文件夹，将其命名为blog（你也可以根据自己的喜好命名，但要注意避免使用特殊字符和空格）。这个文件夹将作为博客项目的根目录，后续所有与博客相关的文件和操作都将在这个目录下进行。

安装Hexo命令行工具

打开命令行工具，进入你刚刚创建的博客目录。在命令行中输入以下命令来安装 Hexo：

1	npm install hexo-cli -g

安装完成后，输入以下命令来验证 Hexo 是否安装成功：

hexo -v

如果成功安装，命令行中会显示 Hexo 的版本信息。就像上图一样。

初始化博客

在安装好hexo的命令行工具之后我们就可以在各种终端里面去执行hexo的命令了，在命令行中输入以下命令来初始化博客：

hexo init

大家在这一步很有可能遇到这个问题：

这个问题是系统权限问题，我们需要使用管理员权限来执行命令。

用管理员权限打开命令行工具然后重试即可。

当然也有可能遇到github端口连接超时的情况。

这种情况的话我就建议你去换一个更好的科学上网工具解决了，很有可能是你用的那种“加速器”效果不好导致的。

当然也有替代方案，就是去下载ZIP然后手动下载依赖项。

先前往hexo-starter仓库下载zip，然后解压到刚刚创建的blog文件夹中。

在执行npm install下载依赖项也可以实现相同的效果。

在初始化了你的博客文件夹之后你就会看到这样的目录结构：

📁 文件/文件夹	🎯 作用说明
📂 .github	存放GitHub相关配置文件，如Actions工作流
📂 node_modules	Node.js依赖包的存放地，所有插件都住在这里
📂 scaffolds	文章模板的温馨小屋
📂 source	你的创作天地，所有文章和资源都在这里
📂 themes	主题的时尚衣橱，存放各种美丽的博客外观
📄 .gitignore	Git的”隐身斗篷”，告诉Git哪些文件不要追踪
📄 _config.landscape.yml	landscape主题的专属配置文件
📄 _config.yml	博客的”大脑”，核心配置文件
📄 package.json	项目的”身份证”，记录依赖和脚本信息
📄 package-lock.json	依赖版本的”时间锁”，确保环境一致性

💡 小贴士：刚开始接触这些文件时可能会觉得有些复杂，但不用担心！就像学习开车一样，一开始可能觉得仪表盘上的按钮很多，但用久了就会发现每个都有它的用处。最常用的其实就是 source 文件夹（你的文章库）和 _config.yml（核心配置），其他的文件夹大多数时候你都不需要去动它们。