Featured image of post Hugo|从零开始Hugo建站 1

Hugo|从零开始Hugo建站 1

零基础学习git

...
📝 写在前面

从一开始看到各路技术大牛的个人博客,开始萌发起了建站的想法。我不擅长写技术性博客文章(本文怕不是我第一篇也是最后一篇技术博客),只是粗略记录一下我建站的过程。如果你在对hugo博客建立的任何地方有问题,希望这篇可以帮助到你👌。

这个系列记录我从零搭建 Hugo 静态博客的过程。本篇是第一部分,主要讲建站前的准备工作:Git 的安装、本地基本操作、本地与远程仓库的连接,以及一些进阶技巧。如果你已经熟悉 Git,可以直接跳到下一篇。

下一篇会讲如何用 Hugo ,从 0 到 1 完成一个静态博客:通过简单配置自定义博客界面,并把站点免费部署到 GitHub Pages。

一、Git 入门:本地环境配置

镜像加速(推荐,最省事)​ 如果你git下载慢,不想折腾代理,直接在原地址前加一个代理前缀即可

git config --global url."https://gh-proxy.com/https://github.com/".insteadOf "https://github.com/"

1. 安装与检查

git --version   # 查看版本号
git --help      # 查看帮助文档

2. 配置用户信息

git config --list                 # 查看所有配置
git config --list --show-origin   # 查看所有配置及其所在文件

接着配置用户名和邮箱:

git config --global user.name "yourname"                # 全局配置用户名
git config --global user.email "youremail@example.com"  # 全局配置邮箱

也可以单独查看用户配置:

git config user.name    # 查看用户名
git config user.email   # 查看邮箱

3. 常用基础命令

以下是最基本的 Git 操作,全部在本地完成,不涉及远程仓库:

命令作用
git status查看仓库状态
git init创建空仓库或重新初始化已有仓库
git add把文件添加到暂存区
git commit提交改动到仓库
git log打印提交日志
git branch查看、添加、删除分支
git checkout切换分支、标签
git merge合并分支
git tag新建、查看标签

二、连接本地与远程仓库

1. 配置 SSH 密钥

mkdir .ssh                                   # 创建 .ssh 目录(如已存在可跳过)
ssh-keygen -t rsa -C "youremail@example.com" # 生成 SSH 密钥

生成后,把公钥添加到 GitHub 的 Settings 中。

常见报错:fatal: Could not read from remote repository.

解决步骤

一般是 SSH 配置有问题,可按以下步骤排查:

  1. 重新生成密钥:ssh-keygen -t rsa -C "youremail@example.com"
  2. 将密钥添加到 ssh-agent:ssh-add ~/.ssh/id_rsa
  3. 将公钥添加到你的 GitHub 账户
  4. 用 ssh -T git@github.com 验证是否成功

2. 克隆远程仓库

git clone https://github.com/project/repo.git

3. 推送与拉取

  • git push:把本地代码推送到远程仓库
  • git pull:把远程仓库的最新代码拉到本地合并
git push origin main   # 把本地代码推送到远程 main 分支
git pull origin main   # 把远程最新代码更新到本地
#这一变化始于2020年10月,GitHub为了推动更具包容性的术语,将新仓库的默认分支名称从传统的 master 更改为 main‌
本地推送远程库
cd public
git init 
git add .
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/你的名字/你的仓库名.git
git push -u origin main

fatal:remote origin already exiests.

处理方法:git remote rm origin

三、Git 进阶技巧

1. 设置别名

用 alias 给常用命令起别名,可以简化输入。基本语法:

git config --global alias.别名 git命令

例如给 commit 和 status 起别名:

git config --global alias.ci commit   # 用 ci 代替 commit
git config --global alias.st status   # 用 st 代替 status

别名可以根据个人习惯自由设定。设置后,可以在 .gitconfig 文件里看到对应的 alias 配置;不需要时删掉即可。

2. 查看改动

git diff

3. 版本回滚

先用 git log 查看版本号(commit 后面那一长串就是版本号):

git reset --hard 版本号   # 回退并丢弃当前工作区的修改
git reset --soft 版本号   # 回退但保留当前工作区的修改,可重新提交

四、GitHub 实用插件与工具

  1. Octotree:目录树
  2. Sourcegraph:在线代码查看器
  3. GITzip

图床方案:使用 GitHub + PicGo 搭建图床。

参考资料

  1. GitHub-Tutorial(GitHub 小白入门)
  2. fatal: Could not read from remote repository.
  3. fatal: remote origin already exists.
采用 CC BY-NC-SA 4.0 许可协议
🚀
你好,朋友
使用 Hugo 构建 | 主题 Stack 由 Jimmy 设计