为什么要搭建博客？
最近在找资料时看到很多人有一直在坚持写博客，将自己工作和生活中所学到的统统写了下来，让人感慨很多。把这些踩过的坑，学过的路写下来，不仅是自己对所学知识加深印象，也是一种为自己做出总结的好方法。未来自己回头看，也会收获良多吧。以前也注册过公众号，但是由于排版门槛等等，都不了了之，刷推特看了大家的一些推荐，最终决定自己搭建一个网站，希望这次能坚持下去。
技术选型
博客生成器
- 选了Hugo，优点是：
- 静态生成，速度快
- 文件结构简单，符合程序员思维
- 生态丰富，有大量主题可选
主题
- 选了PaperMod，极简风格，适合长期维护
部署平台
- 选了Cloudflare Pages，全自动部署+免费+全球CDN，体验非常棒
搭建记录
1. 安装工具
- Chocolatey安装包管理器 1.打开管理员模式Windows PowerShell 2.执行安装choco命令：
iwr https://community.chocolatey.org/install.ps1 -UseBasicParsing | iex
3.如果此时遇到"因为在此系统上禁止运行脚本的报错"，执行以下命令，执行后输入Y回车确认即可 1.Windows默认禁止外部脚本运行是为了安全，防止下载到恶意脚本 2.Set-ExecutionPolicy RemoteSigned 的意思是：本地脚本都可执行、且从互联网下载的脚本必须有有效签名
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
4.如果担心安全，可以在安装完choco后，把策略改回去
Set-ExecutionPolicy Restricted -Scope CurrentUser
5.安装成功choco后，如果无法判断是否安装成功，可以关闭窗口重新打开Windows PowerShell
choco -v
- Hugo安装 1.安装Hugo，切记要使用管理员模式下的Windows PowerShell执行安装命令
choco install hugo
- Git下载安装及配置环境变量
2. 创建Hugo站点
hugo new site my-blog
3. 选择主题
4.配置主题
git clone https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod
4.1编辑配置文件hugo.toml
theme = 'PaperMod'
5.创建文章
hugo new posts/第一篇文章.md
5.1使用VS Code编辑器进行编辑
- 安装扩展插件：Markdown Preview Enhanced及Markdown All in One
- 使用快捷键：Ctrl+Shift+V 进行预览
6.本地预览
hugo server
7.配置Cloudflare Pages
- 绑定GitHub仓库
- 选择Hugo构建环境
- 设置版本和构建命令
- 自动发布上线
8.遇到的坑
| 问题 | 解决方法 |
|---|---|
| PowerShell 禁止运行脚本 | Set-ExecutionPolicy RemoteSigned |
| git 已安装，但无法在任意文件夹进行 clone | 在系统环境中配置 git |
| 部署时，皮肤主题在系统路径一直错误，导致失败 | 将之前的皮肤文件删除重新clone，成功后本地尝试是否可以正常使用皮肤 |
| 部署时，提示hugo版本太低，不支持皮肤 | 配置一个变量HUGO_VERSION:当前使用HUGO版本号 |
9.最终成果
- 博客成功上线：https://xianshu-wang.pages.dev/