😃 此博客为自学数学建模和人工智能(机器学习、深度学习和大模型)的分享博客,整理了许多笔记(持续更新中......)。
👏 高考数学144;全国大学生数学竞赛一等奖(预赛);华为杯中国研究生数学建模竞赛一等奖。
⭐ 基于Hexo下的fluid主题开发,以帮助更多数学建模和机器学习初学者,祝愿大家都能取得好成绩!如果觉得有用,请点个star 吧!感谢!!
🚩 同时,也欢迎大家PR,共同将这个项目壮大!
机器学习与深度学习: XGBoost、LightGBM、CatBoost、PyTorch、TensorFlow、CNN、RNN、LSTM、Transformer
运筹优化: Google OR-Tools、线性规划、整数规划、APS系统、生产排程优化
大模型与AI: Prompt工程、大模型接入、智能体开发、AI工具应用
开发工具: Python、C++、Docker、Git、uv、poetry、conda
应用领域: 数学建模、计算机视觉、语音识别、数据科学、AGV调度
博客地址: https://qzkq.github.io
公众号: 数学建模与人工智能
Git 官网: https://git-scm.com/downloads
安装步骤简单不再介绍,安装完成后通过以下命令查看安装版本号:
git --versionssh-keygen -t rsa -C "你的邮箱@qq.com"注意: 邮箱填写 GitHub 绑定的邮箱。
cd ~/.ssh # 切换目录到这个路径
vim id_rsa.pub # 将这个文件的内容显示到终端上也可以直接前往 .ssh 文件所在的路径(~/.ssh),然后打开 id_rsa.pub 这个文件,同样可以看到里面的内容。
- 访问 https://github.com/settings/keys
- 点击
New SSH key - 粘贴公钥内容
- 保存
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的邮箱@qq.com"通过 GitHub 创建一个新的 repository,名称为 用户名.github.io(添加 README 可以勾选上,后续可以介绍一下你的 Blog)
Node.js 官网: https://nodejs.org/zh-cn/
exe 安装直接 Next 即可(安装路径默认在 C 盘,建议更换到其他盘)。
node -v
npm -v # nodejs 安装默认附带安装 npm在 Node.js 安装目录下创建 node_global、node_cache 两个文件夹(全局安装的模块路径和缓存路径)。
npm config set prefix "D:\nodejs\node_global"
npm config set cache "D:\nodejs\node_cache"
# 如显示权限不够,用管理员打开 cmd配置系统环境变量:
- 右键此电脑,点击属性
- 打开高级系统设置,环境变量
- 编辑系统变量,新建
NODE_PATH变量,变量值为node_modules地址 - 将用户变量下 Path 的
C:\Users\用户名\AppData\Roaming\npm修改为D:\nodejs\node_global
防止 npm 下载过慢,使用国内淘宝镜像(新版):
npm config set registry https://registry.npmmirror.com通过 cmd 用 npm 安装 hexo 并初始化本地博客文件夹:
npm install hexo-cli -g
hexo init 用户名.github.io # 这里替换成你自己的,为后续更新到 github 上,使用用户名.github.io
cd 用户名.github.io # 进入本地的博客文件夹
npm install
hexo server # 打开本地服务器预览之后通过浏览器查看 http://localhost:4000/ 是否成功。
注: 可以通过 hexo -v 查看 hexo 安装版本。
Hexo 主题官网: https://hexo.io/themes/
可以通过 GitHub 搜索查看 stars 数大于 3000 的主题都有哪些,这里我们使用 Fluid。
npm install --save hexo-theme-fluid通过 npm 安装的主题会放在 node_modules 里,然后在之前创建的博客目录下创建 _config.fluid.yml,将该主题下的 _config.yml 内容复制进去。
修改博客目录中的 _config.yml,修改两个字段:
language: zh-CN # 指定中文
theme: fluid # 指定主题其他配置可参考 Hexo Fluid 用户手册:配置指南,介绍得很详细,_config.fluid.yml 中也有很详细的注释。
hexo clean # 清空一下缓存,有时候博客页面显示不正常也可以试试这个命令
hexo g # hexo generate 的简写,把刚刚做的改动生成更新一下
hexo server # 在本地服务器看看博客有没有更新成 Fluid 主题:https://localhost:4000修改博客根目录下的 _config.yml 文件中的 deploy:
deploy:
type: git
repo: git@github.com:你的用户名/你的用户名.github.io.git # 这里我用的是 ssh,也可以用 https,可能会报错,设置 token 即可
branch: main # 注意自己创建的分支,我的是 main,有可能是 master安装 hexo-deployer-git 自动部署发布工具,将 hexo 部署到 git page 的 deployer:
npm install hexo-deployer-git --save部署到 GitHub:
hexo d # hexo deploy,如果本地服务器没问题就可以上传到 github 上更新博客之后,可以通过如下命令上传到 GitHub:
hexo clean # 清空一下缓存,有时候博客页面显示不正常也可以试试这个命令行
hexo g # 是 hexo generate 的简写,把刚刚做的改动生成更新一下
hexo server # 在本地服务器看看博客有没有更新:https://localhost:4000
hexo d # hexo deploy,如果本地服务器看了没问题就可以上传到 github 网站在博客目录下的 node_modules\hexo-theme-fluid\layout\layout.ejs 的 <header>***</header> 中,将从网站 https://tholman.com/github-corners/ 中复制喜欢的颜色图标代码粘贴即可。
推荐一个图片网址:https://wallpaperhub.app/,可以选择尺寸下载。
# 重命名,用 github 代替 git@github.com:用户名/仓库名.git
git remote github git@github.com:你的用户名/你的仓库名.gitgit status说明:标红色的文件表示未提交到缓存区,绿色字表示已经添加到了缓存区。
git add .提交到缓存区后可以再次使用 git status 查看文件状态,如果所有文件都为绿色,证明已经添加到了缓存区。
git commit -m '备注信息'备注信息应该简洁明了地说明本次提交的内容,例如:
- "添加新文章:Hexo Fluid 博客搭建指南"
- "修改主题配置:更新导航栏菜单"
- "修复图片显示问题"
git pull这一步可以确保你的代码是最新的,要拉取 git 上的代码。
git push origin 分支名注: git push 用于从将本地的分支版本上传到远程并合并。
git push origin main # 将本地的 main 分支推送到 origin 主机的 main 分支为了防止提交代码时出现错误,通常都会先提交到分支里面,确认不会出现问题以后再将代码合并到主分支。
说明:
main是新创建 GitHub 仓库的默认分支master是旧版本的默认分支
# 1. 创建新分支用于开发
git checkout -b dev
# 2. 在分支上进行修改和提交
git add .
git commit -m '开发新功能'
# 3. 推送分支到远程仓库
git push github dev
# 4. 确认无误后,切换到主分支并合并
git checkout main
git merge dev
# 5. 推送主分支
git push github main为了避免提交不必要的文件,建议在博客根目录创建 .gitignore 文件:
# Hexo 生成的静态文件
public/
db.json
*.log
# Node.js 依赖
node_modules/
# IDE 配置文件
.vscode/
.idea/
*.swp
*.swo
*~
# 系统文件
.DS_Store
Thumbs.dbhexo new "文章标题"这会在 source/_posts/ 目录下生成一个 Markdown 文件。
编辑生成的 Markdown 文件,设置文章的 Front-matter:
---
title: 文章标题
date: 2026-01-09 12:00:00
categories: 分类名称
tags: [标签1, 标签2]
index_img: /img/cover.jpg # 封面图
banner_img: /img/banner.jpg # 文章页头图
---
文章正文内容...hexo s访问 http://localhost:4000 查看效果。
hexo clean
hexo ghexo d访问 https://你的用户名.github.io 查看更新后的博客。
# 创建新文章
hexo new "文章标题"
# 创建新页面
hexo new page "页面名称"
# 启动本地服务器(端口 4000)
hexo server
# 清除缓存和静态文件
hexo clean
# 生成静态文件
hexo generate
# 部署到远程服务器
hexo deploy
# 组合命令:生成并部署
hexo clean && hexo g && hexo d# 初始化 Git 仓库
git init
# 添加远程仓库(重命名为 github)
git remote github git@github.com:你的用户名/你的仓库名.git
# 查看修改过的文件(红色表示未暂存,绿色表示已暂存)
git status
# 将代码提交到缓存区
git add .
# 提交代码并备注
git commit -m '备注信息'
# 拉取远程仓库最新代码
git pull
# 推送到远程仓库
git push github main
# 查看所有分支
git branch
# 创建新分支
git branch 分支名
# 切换分支
git checkout 分支名
# 创建并切换到新分支
git checkout -b 分支名
# 合并分支到当前分支
git merge 分支名
# 删除分支
git branch -d 分支名
# 查看提交历史
git log
# 查看远程仓库信息
git remote -v
# 暂存当前工作区的修改
git stash
# 恢复暂存的修改
git stash pop
# 丢弃本地修改
git checkout -- 文件名.
├── _config.yml # Hexo 主配置文件
├── _config.fluid.yml # Fluid 主题配置文件
├── package.json # 项目依赖配置
├── scaffolds/ # 模板文件夹
├── source/ # 资源文件夹
│ ├── _posts/ # 文章源文件
│ ├── img/ # 图片资源
│ └── about/ # 关于页面
├── themes/ # 主题文件夹
├── public/ # 生成的静态文件(不要手动修改)
└── node_modules/ # Node.js 依赖(不要手动修改)
如果需要直接将 Hexo 生成的静态文件推送到 GitHub Pages 仓库,可以使用以下命令:
# 1. 进入 public 文件夹(Hexo 生成的静态文件)
cd public
# 2. 初始化 git(如果还没初始化)
git init
# 3. 添加远程仓库(替换为你的仓库地址)
git remote add origin https://github.com/你的用户名/你的仓库名.git
# 4. 先拉取远程仓库最新代码(避免冲突)
git pull origin main --allow-unrelated-histories
# 5. 添加文件并提交
git add .
git commit -m "手动更新静态文件"
# 6. 推送到 GitHub Pages 分支(通常是 main、master 或 gh-pages)
git branch -M main
git push -u origin main
# 使用强制推送覆盖远程仓库
git push -u origin main --force注意:
- 这种方式适用于不想使用
hexo d命令自动部署的情况 - 强制推送(
--force)会覆盖远程仓库,请谨慎使用 - 推送前先拉取(
git pull)可以避免冲突,确保远程仓库最新 --allow-unrelated-histories参数用于合并两个不相关的历史记录- 推送完成后记得回到项目根目录:
cd ..
- 检查仓库名称是否正确(必须是
用户名.github.io) - 检查
_config.yml中的url配置 - 等待 GitHub Pages 构建完成(通常需要 1-3 分钟)
- 确保图片放在
source/img/目录 - 使用相对路径引用:
/img/图片名.jpg - 图片名不要使用中文或特殊字符
- 确保已配置 SSH 密钥
- 检查
_config.yml中的仓库地址是否使用 SSH 格式 - 验证 GitHub 仓库权限
- 运行
hexo clean清除缓存 - 重新生成并部署:
hexo g && hexo d - 检查主题是否正确安装
# 如果出现合并冲突,可以使用以下命令解决
git pull --rebase
# 手动解决冲突后
git add .
git rebase --continue
git push# 撤销最后一次提交(保留修改)
git reset --soft HEAD^
# 撤销最后一次提交(不保留修改)
git reset --hard HEAD^本博客内容采用 CC BY-NC-SA 4.0 许可协议进行许可。
开始搭建你的博客吧! 🎉
如果觉得这个项目对你有帮助,请点个 Star 支持一下!感谢!!