1. 初始化环境（仅首次或换电脑时）#

• 先安装好 Node.js 的 LTS 版本（建议 20.x）；
• 安装好 Node.js 后，使用 pnpm（替代 npm，速度更快，磁盘占用更少）。如果未安装，先运行：

1
npm install -g pnpm

进入项目目录并安装依赖：

1
cd YOUR\PATH\TO\leehenry-blog
2
pnpm install

结果：生成 node_modules/ 文件夹，包含 Astro、Tailwind 等依赖。

2. 启动本地开发#

1
pnpm dev

• 启动 Vite 开发服务器，浏览器访问 http://localhost:4321。
• 修改文章/样式/配置文件后页面会自动热更新。

3. 写文章 / 改配置#

1
# 语法
2
pnpm run new-post <栏目> <目录名> [-t "标题"]
3

4
# 示例：我这样做事 / HT-Vol02
5
pnpm run new-post 我这样做事 HT-Vol02 -t "效率系统二次迭代"
6

7
# 示例：野语不成篇（支持别名 wild/yy）
8
pnpm run new-post wild YY-Vol01 -t "零散片语"

1
src/content/posts/我这样做事/
2
  HT-Vol02/         ← 图片文件夹（放 cover.jpg 等）
3
  HT-Vol02.md       ← 文章文件

1
---
2
title: 效率系统二次迭代
3
published: 2025-08-25
4
description: ''
5
image: ''
6
tags: []
7
category: 我这样做事
8
draft: false
9
lang: ''
10
---

4. Git 管理#

1
git add -A
2
git commit -m "feat: 新增文章《xxx》"
3
git push

1
git status

1
git add -A
2
git commit -m "feat(nav): add icons for nav links"

1
git push

1
git remote add upstream https://github.com/saicaca/fuwari.git
2
git fetch upstream
3
git checkout main
4
git merge upstream/main

5. 构建网站（生成静态文件）#

1
pnpm build

• Astro 会输出静态 HTML/CSS/JS 文件到 dist/ 目录。
• 本地预览打包结果：

1
pnpm preview

1. 配置免密登录（仅首次或换新电脑时）#

1
ssh-keygen -t ed25519 -C "your_email@example.com"
2
type %USERPROFILE%\.ssh\id_ed25519.pub | ssh -p 22 root@YOUR_SERVER_IP "umask 077; mkdir -p ~/.ssh; cat >> ~/.ssh/authorized_keys"

验证：

1
ssh -i %USERPROFILE%\.ssh\id_ed25519 -p 22 root@YOUR_SERVER_IP "echo ok"

出现 ok 即免密成功。

2. 部署上线#

1
deploy.bat

1. astro 模块消失问题#

场景：在 dev/build 的时候报错找不到 astro 模块，node_modules 下的 astro 文件夹莫名其妙消失。

1
Error: Cannot find module '...\leehenry-blog\node_modules\astro\astro.js'

解决：重装一下就好了。在项目目录下执行：

1
pnpm install
2
pnpm build

2. 多设备切换与冲突解决#

场景：我在 A 电脑开发并 git push，接着换到 B 电脑继续开发并再次 git push。当我回到 A 电脑时，本地仓库就会落后于远端最新状态。可能此时 A 电脑还有一些未提交或未 push 的改动。

1
git fetch origin
2
git reset --hard origin/main

1
git pull

1
def hello():
2
<<<<<<< HEAD
3
    print("Hello from A")
4
=======
5
    print("Hello from B")
6
>>>>>>> origin/main

1
git add 冲突文件
2
git commit

📌 脚本简介#

这是一个一键部署脚本，适用于 Windows 环境，主要功能包括：

1. 本地构建：调用 pnpm build 或 npm run build 生成静态资源。
2. 远端部署：自动备份远端站点 → 清理旧文件 → 上传并解压新版本 → 修正权限。
3. 版本管理：在本地仓库执行 git add / commit / push，支持自定义提交信息。
4. 失败重试：每个步骤独立，如果失败只需重试该步骤，而不是整个流程。
5. 代理支持：可选仅为 Git 推送设置代理（适合国内环境，上传服务器走直连，GitHub 推送走代理）。

⚙️ 使用方法#

1. 将脚本命名为 deploy.bat，放在和 leehenry-blog 同级目录下。

   1
   project-root/
   2
   ├─ leehenry-blog/         # 博客源码目录
   3
   ├─ deploy.bat             # 部署脚本
   

2. 双击运行或在命令行执行：

   1
   deploy
   

3. 脚本会依次执行构建、上传、远端解压和推送 Git。

运行时会显示每个步骤的耗时与日志，失败时可以选择：

• R → 仅重试该步骤
• E → 退出脚本

🛠️ 可配置项#

在脚本开头（CONFIG 区域）可修改以下配置：

• 部署参数

  1
  set "HOST=39.104.64.173"              REM 远端服务器 IP
  2
  set "PORT=22"                         REM SSH 端口
  3
  set "USER=root"                       REM SSH 用户
  4
  set "REMOTE_DIR=/www/wwwroot/39.104.64.173"   REM 部署目录
  5
  set "WWW_USER=www"                    REM 文件属主
  6
  set "WWW_GROUP=www"                   REM 文件属组
  7
  set "KEY=%USERPROFILE%\.ssh\id_ed25519"       REM SSH 私钥路径
  

• Git 代理（仅影响 HTTPS 推送，不影响 SSH）

  1
  set "GIT_PROXY_ENABLE=1"              REM 1=启用，0=禁用
  2
  set "GIT_PROXY_URL=http://127.0.0.1:2020"
  

• 其它

  1
  set "PAUSE_AT_END=1"                  REM 脚本结束后是否暂停
  2
  set "BACKUP=1"                        REM 是否自动备份远端旧版本
  

💡 使用场景#

• 正常部署：直接运行脚本，自动完成全流程。
• 修改提交信息：在 Step 8 时输入自定义 commit message，按回车则默认 "feat: update new posts"。
• 跳过 Git 代理：将 GIT_PROXY_ENABLE=0，或把仓库远程改为 SSH 地址。
• 失败重试：如果某一步失败，输入 R 仅重试该步骤，无需从头再跑。

❓ 常见问题#

• Q: 为什么 Git 推送时报错？ A: 检查远程 URL 是否是 HTTPS，只有 HTTPS 才会走代理。SSH (git@...) 推送不会使用 HTTP 代理。
• Q: 我不想每次都用代理怎么办？ A: 修改脚本，把 GIT_PROXY_ENABLE=0。
• Q: 远端文件夹会不会清空？ A: 是的，会清理目标目录下的文件，但保留 .well-known 和 .user.ini。如果需要更多保留文件，请在 Step 3 修改规则。
• Q: 构建工具找不到怎么办？ A: 脚本会优先尝试 pnpm，若未安装则 fallback 到 npm run build。