环境准备#

1. Node.js——推荐使用pnpm作为node包管理工具

2. VS Code——安装扩展：Github Actions、Astro

3. Git——将博客推送到Github上

创建项目#

Astro和Hexo一样拥有非常多的主题，但不同的是，Hexo可以安装多个主题，通过配置文件切换，而Astro每个主题就是一个项目，每位主题作者使用的frontmatter格式可能都不相同。因此，为了避免项目大改，请先选择心仪的主题。

1
# 通过Github拷贝项目模板(主题)：
2
git clone https://github.com/saicaca/fuwari Astro-Fuwari
3

4
# 通过pnpm创建项目模板(主题)：
5
pnpm create astro@<版本> <项目名称> --template <主题作者>/<主题仓库>
6
pnpm create astro@latest Astro-Fuwari --template saicaca/fuwari

预览模式启动Astro#

Astro框架带有预览模式，方便我们看到刚修改的项目运行情况。

1
npm install -g pnpm      # 安装pnpm
2
pnpm add sharp        # 向package.json添加依赖项
3
pnpm install        # 根据package.json中的依赖项安装所有依赖
4
pnpm run dev        # 运行预览模式

新建文章#

1
pnpm new-post <filename>

可以在 src/content/posts/ 目录中编辑

配置git用户名和邮箱#

1
# git bash
2
git config --global user.name <用户名>    // 设置全局的git用户名
3
git config --global user.email <邮箱地址>  // 设置全局的git用户邮箱
4

5
git config --list  // 检查是否设置成功

GitHub创建新的仓库#

最好选择 private ，毕竟上传的是网站的源码。输入仓库名，其他默认

通过ssh连接GitHub#

可以选择https连接，但有可能会出现连接失败，用ssh连接就没问题了。

可能会遇到以下错误信息：

1
fatal: could not read Username for 'https://github.com': No such device or address'
2
fatal: unable to access 'https://github.com/xxx/xxx.git': Failed to connect to github.com port 443: Timed out'

说明VSCode无法连接到GitHub，导致操作失败。这种情况可能出现在以下几种情况下：

1. 没有正确配置GitHub账户信息
2. GitHub账户验证信息过期或无效
3. 网络连接不稳定或存在代理问题

生成公钥和私钥

1
ssh-keygen -t rsa -C <邮箱地址>

打开 C:\Users\用户.ssh 文件夹

配置ssh免密登录#

将id_rsa.pub公钥文件内容复制，进入github设置里配置ssh

将复制的内容粘贴到 Key 中，Title 随意。

验证设置是否成功#

使用以下命令验证 SSH 密钥是否配置成功： 显示 successfully 说明配置成功，后面的提示只是告诉你，github 不允许 shell 交互，并非报错。

1
ssh -T git@github.com

远程仓库初始化#

用VS Code打开项目文件夹，在终端里输入

1
git init  // 本地仓库初始化
2
git add README.md  // 添加readme.md文件
3
git commit -m "first commit"  // 初次提交
4
git branch -M main  // 构建分支
5
git remote add origin git@github.com:<GitHub用户名>/<GitHub仓库名>  // 连接到GitHub仓库
6
git push -u origin main  // 推送

推送到GitHub#

每次修改代码保存后，在源代码管理会有这样的提示。在上方输入本次提交的简述后，点击提交，将本次所有修改都提交到本地仓库

再点击同步更改，或是推送，将本地仓库推送到GitHub上。

设置自定义域（可选）#

进入刚刚创建的Pages项目，点击设置自定义域，填入域名或子域名。