新电脑克隆部署指南：从 GitHub 拉下博客就能跑

这篇文章写给换电脑 / 重装系统后的自己：如何从 GitHub 把博客完整拉下来，几分钟内恢复开发环境。全程只需 5 步，核心就一句话——装好 Node 和 Git，克隆，pnpm install，pnpm dev。

一、新电脑要装什么

就两样：Node.js 和 Git。

# 验证是否已安装
node --version    # 需要 ≥ 18.17，推荐 20 或 22 LTS
git --version

Node.js：去官网下载 LTS 版安装包，一路下一步
Git：官网下载安装包；Windows 装完建议重开终端（PATH 才会生效）

二、启用 pnpm

Node 自带 corepack，一条命令就能启用 pnpm（无需全局安装）：

corepack enable
pnpm --version    # 11.24.0

⚠️ 如果 PowerShell 报「禁止运行脚本」，放开当前用户的执行策略：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

三、克隆项目

git clone https://github.com/nan-yy/nanyu-blog.git
cd nanyu-blog

📦 仓库约 40-50MB（含字体和图片资源），克隆稍慢属正常。

四、安装依赖（最关键的一步）

pnpm install

两个注意点：

千万别复制旧电脑的 node_modules —— 这个目录是 pnpm 用符号链接搭的，直接拷贝到新电脑几乎必坏（astro 会报 Cannot find package 'kleur' 之类），必须在新电脑上重新 pnpm install
必须用 pnpm，不要用 npm —— 本项目锁定 pnpm；pnpm-workspace.yaml 里已预配置 esbuild / sharp / swup 的构建白名单，安装不会卡在交互审批

五、启动与日常写作

# 开发服务器 → http://localhost:4321（改代码自动刷新）
pnpm dev

# 写新文章
pnpm newpost '文章标题'

# 生产构建 + 本地预览
pnpm build
pnpm preview

文章文件在 src/content/blog/ 下，直接建 .md 文件也可以，front-matter 格式：

---
title: 文章标题
categories: 分类
tags: [标签1, 标签2]
id: "唯一ID"
date: 2026-08-28 23:50:00
cover: "/assets/images/covers/xxx.png"   # 不填则随机内置封面
recommend: true   # 是否推荐文章
top: true         # 是否置顶
---

六、常见问题排查

问题	解决
`pnpm` 不是内部或外部命令	执行 `corepack enable`，然后重开终端
PowerShell 禁止运行脚本	`Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`
`ERR_PNPM_ABORTED_REMOVE_MODULES_DIR_NO_TTY`	执行一次 `pnpm install`（或临时设 `CI=true`）
安装报构建脚本未批准	`pnpm approve-builds` 勾选 esbuild / sharp / swup
页面里图片 404	检查是否完整克隆（图片在 `public/assets/images/` 下，随仓库提交）

总结：装 Node + Git → corepack enable → git clone → pnpm install → pnpm dev。以后换电脑，照着这篇几分钟就能把博客搬回来。

南与