skip to content
Astro Cactus

Astro博客搭建流程与注意事项

/ 2 min read

astro, blog, github, vercel

1. 环境准备

Node.js 安装

Terminal window
# 使用 Homebrew 安装
brew install node
brew install pnpm


# 验证安装
node --version
pnpm --version

2. 创建 Astro 项目

初始化项目

Terminal window
pnpm dlx create-astro my-blog --template chrismwilliams/astro-theme-cactus
cd my-blog
pnpm install
pnpm dev

3. Git 与 GitHub 配置

初始化 Git 仓库

Terminal window
cd my-blog          # 确保在正确目录
git init
git add .
git commit -m "first commit"
git branch -M main

关联 GitHub

Terminal window
git remote add origin https://github.com/username/my-blog.git
git push -u origin main

4. 多设备管理

SSH Key 配置

Terminal window
# 在每台设备上生成 SSH Key
ssh-keygen -t ed25519 -C "[email protected]"


# 查看公钥内容
cat ~/.ssh/id_ed25519.pub

GitHub 添加多个 SSH Key

  1. 访问 GitHub -> Settings -> SSH and GPG keys
  2. 点击 “New SSH key”
  3. 为每台设备的 Key 添加不同的标题（如：“MacBook Pro”、“Windows Desktop”）
  4. 粘贴对应设备的公钥内容

Git 全局配置

在每台设备上设置相同的 Git 配置：

Terminal window
# 设置用户名和邮箱
git config --global user.name "Your Name"
git config --global user.email "[email protected]"


# 建议设置默认分支名称
git config --global init.defaultBranch main

工作流程

  1. 首次在新设备上使用：
Terminal window
# 克隆仓库
git clone [email protected]:username/my-blog.git
cd my-blog
pnpm install  # 安装依赖
  1. 日常同步流程：
Terminal window
# 开始工作前先拉取最新代码
git pull


# 完成修改后推送
git add .
git commit -m "update: 更新说明"
git push

5. 日常维护流程

更新博客

Terminal window
# 拉取最新代码
git pull


# 本地开发
pnpm dev


# astro check 检查语法
pnpm astro check


# 提交更改
git add .
git commit -m "update: 更新说明"
git push

7. 参考资源