本文共 1832 字，大约阅读时间需要 6 分钟。

如何基于Windows搭建个人技术博客

在Windows环境下搭建个人技术博客并托管于GitHub，可以通过以下步骤轻松实现。本文将详细介绍从创建GitHub仓库到部署完成的各个步骤。

1. 创建GitHub Repository

首先，你需要在GitHub上创建一个仓库。仓库的命名格式应遵循以下要求：

-仓库名称：你的GitHub账户名 . github.io

例如，如果你的GitHub账户名是 username，则仓库名称应为 username.github.io。如果你已经存在于GitHub上并尝试过创建过仓库，系统会提示你仓库名已经存在。

注意： 如果你希望将仓库添加为项目.website，在创建仓库时不一定要遵循特定格式。你只需按照上述方式创建仓库，之后在配置过程中设置内容。

2. 安装必要工具

在继续之前，确保你的计算机环境已准备好。下面将指导你安装必要的工具：

安装Node.js

• 运行以下命令（以管理员身份打开命令提示符）：

  https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install-win.cmd

  等待安装完成。

安装Git

• 下载并安装最新版本的 Git 针对Windows的版本。

验证安装是否成功

• 查看Node.js版本：

  node -v

• 查看npm版本：

  npm -v

• 查看Git版本：

  git --version

  如果以上命令均返回相应版本，说明工具已成功安装。

3. 安装Hexo

接下来，安装Hexo，将用于创建和管理个人博客。

1. 设置npm镜像地址

• 将npm的镜像地址切换为 GitHub China 的镜像仓库：

  npm config set registry https://registry.npm.taobao.org

  等待镜像加载。

2. 安装Hexo

• 运行以下命令安装Hexo 并初始化项目：

  npm install -g hexo
  hexo init

  或者：

  npm install hexo --global
  hexo init

注意： 如果你在非Hexo文件夹中运行 hexo init，将无法启动服务器，将会提示帮助信息。确保在Hexo文件夹中执行该命令。

3. 启动本地服务器

• 使用 hexo g 生成博客内容：

  hexo g

• 启动服务器：

  hexo s

  服务器启动后，你将可以通过本地浏览器访问博客。

• 如果你希望更改服务器的默认端口（即 ":4000"），可以在启动时指定：

  hexo s -p 6000

注意： 端口号可根据你自己的需求进行调整，默认为4000。

4. 将博客部署到GitHub

最后一步是在GitHub上托管你的博客内容。

1. 安装GitHub部署工具

• 在GitHub Bash 中安装一个名为 hexo-deployer-git 的插件：

  npm install hexo-deployer-git --save

  这将添加一个 deployer.json 文件于项目文件夹中。

2. 配置文件

• 打开 _config.yml 文件（位于Hexo文件夹中），将文件末尾添加以下内容：

  deploy:
    provider: github
    repo:  # 更新为你的GitHub仓库地址

  将 repo 替换为你的GitHub仓库地址。例如，如果仓库名为 username.github.io，则 repo 应填写 username/username.github.io 或直接 username.github.io。

5. 部署博客

• 在你准备好的Hexo文件夹中运行以下命令：

  hexo d

  这将将内容部署到GitHubitm的仓库上。

• 访问GitHub后，切换到你的GitHub仓库名strtolower，并选择“GitHub Pages”选项。你将看到生成的博客地址。

注意： 如果你将仓库名设置为 username/username.github.io，生成的URL将为 https://username.github.io/repositoryname/。为了获得更短的URL，建议将仓库名设置为 username.github.io。

总结： 搭建个人技术博客的过程相对简单。只要按照上述步骤一步步进行，你将能够成功在GitHub上托管你的技术博客。如果遇到问题，不妨参考相关资料或详细教程解答。