推开门就是明天

Mac 搭建 Astro 博客实录：从 Node.js 到战胜 Git 报错

Thu, 08 Jan 2026 00:00:00 GMT

最近心血来潮，想搭建一个属于自己的独立博客。作为一名对颜值有要求的设计师，我最终选中了 Astro 框架搭配高颜值的 Fuwari 主题，并计划使用 Vercel 进行自动部署。

本以为在 Mac 上操作会很丝滑，结果在环境配置，尤其是推送到 GitHub 的过程中，结结实实地踩了一堆坑。这篇文章把我的“踩坑”和“填坑”过程记录下来，希望能帮到同样使用 Mac 的朋友。

1. 起步：安装 Node.js 环境

因为 Astro 是基于 JavaScript 的框架，第一步必须给 Mac 装上 Node.js 环境。

对于 Mac 用户，最简单的方式其实是去 Node.js 官网下载 .pkg 安装包，或者如果你是开发者，可以使用 Homebrew 安装。

安装好后，打开终端验证一下：

node -v
# v24.x.x (成功显示版本号即为正常)
环境装好后，初始化博客项目非常快，直接运行官方命令：

```bash
npm create astro@latest -- --template yCENzh/Fuwari-yCENzh

最大的拦路虎：Git 推送与权限验证本地博客跑通了 (npm run dev)，效果很棒。但当我准备把它推送到 GitHub 上以便 Vercel 部署时，真正的折磨开始了。

遭遇战一：Git 不再支持密码验证我在终端按照 GitHub 的提示运行 git push，输入了我的 GitHub 账号密码，结果直接报错：

、、、remote: Support for password authentication was removed on August 13, 2021. fatal: Authentication failed 、、、原因：GitHub 为了安全，早就取消了在命令行直接输登录密码的方式，现在必须使用 Personal Access Token (个人令牌) 或者 SSH 密钥。

✅ 我的解决方案：一开始我想去生成 Token，但在终端里粘贴 Token 总是因为格式或权限问题失败。后来我发现 VS Code 自带的“源代码管理” 才是神器：

点击 VS Code 左侧的“源代码管理”图标（那个像树杈一样的图标）。

点击 “发布分支” (Publish Branch) 或 “同步更改” (Sync Changes)。

VS Code 会自动跳出弹窗请求 GitHub 授权。

点击允许，浏览器自动完成登录验证。

根本不需要手输 Token，直接搞定身份验证！遭遇战二：HTTP/2 网络协议报错解决了身份验证，我以为稳了，结果进度条跑了一半又断了，出现了更诡异的报错：

fatal: unable to access '...': Error in the HTTP2 framing layer

或者： RPC failed; HTTP 400 curl 22 The requested URL returned error: 400

原因：这是 Git 默认使用的 HTTP/2 协议在某些网络环境下（特别是在国内连接 GitHub 时）出现了“水土不服”，导致数据包传输中断或重置。

✅ 终极解决方案：不需要开复杂的代理，也不需要改 hosts，只需要在终端执行一条命令，强制 Git 使用更老、更稳的 HTTP/1.1 协议：

git config --global http.version HTTP/1.1

运行完这行命令后，再次点击推送，进度条瞬间跑满 Writing objects: 100%，上传成功！遭遇战三：Git 忘记了我是谁在某次提交时，我还遇到了这个经典的“新手”报错：

fatal: no email was given and auto-detection is disabled

这个问题最简单，Git 需要知道提交代码的人是谁。补上身份信息就行：

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

上线：Vercel 一键部署代码成功推送到 GitHub 后，剩下的事就非常简单了：

点击 "Add New Project" -> "Import from GitHub"。

选中我的博客仓库。

点击 Deploy。

等待大约一分钟，屏幕撒花，我的博客正式上线。

lonely christmas

Thu, 25 Dec 2025 00:00:00 GMT

这个城市没有Christmas，只有我一个人的Lonely Christmas。键盘敲完，又是错过夕阳的一天，我也记不清这是第几次只看到月亮了。如果不加班，也许我会玩会儿游戏，但这改变不了这座城市的陌生和日子的艰难。

我觉得自己是一个在星夜里一直与世界逆行的人。为了不顺从，我做尽了选择，结果却是让自己变得越来越陌生。那种陌生，就像我们之间从未有过交集，也像那些从未被你在意过的某一天。

海菜

Thu, 25 Dec 2025 00:00:00 GMT

那盏路灯连同灯下的二叔，缩成了黑夜里一颗遥远的星星。

三年前，我考上了大学。

填志愿时少年意气，血一下子涌上头，大笔一挥，选了个离家两千公里的城市。家里人苦劝未果，最终也只能随我。

出发前，我特意回了趟老家，想看看二叔再走。

二叔命苦。儿子麦子年初发急病走了，老婆十年前也跑了。如今，只剩他一个人在乡下，守着几亩麦田过活。

到他家门口时，我用力拍门。二叔上了年纪，耳背，眼睛也灰蒙蒙的，像两只钨丝烧断了的废灯泡。

屋内传来浑浊的吼声：“谁啊？”

我也只能大声吼回去，唯有这样他才能听清。

屋里传来一阵哐哐啷啷的声响，二叔终于开了门。我冲他喊：“二叔，我考上大学了，来跟你说一声！”

他脸上堆起笑，皱纹舒展开来。我接着说：“我还想去看看麦子，也跟他说一声。”

二叔连声说好，拎着香烛纸钱带我去坟头。

那里好大一片，入眼皆是“先考”与“先妣”。麦子的墓碑立在外公外婆旁边，我家几代先人都在这，村里老人走后也都要归于此地。

点燃香烛，我对着墓碑轻声说：“麦子，我考上大学了，你在下面要好好的。”

身后忽然传来二叔的抽泣声。

我回头看他，他慌乱地摆手，扯着嗓子吼：“不是伤心！是开心！我是开心你考上大学！”

我说：“好，我知道。”

眼泪却止不住地流下来，滑过脸颊，滴在燃烧的纸钱上，发出“嗤嗤”的声响。

回去的时候，天色已近昏黄。

我们走在田埂上，四周种满了麦子，在晚风中起伏如浪。

二叔忽然停下，说要给我带点东西。我推辞说城市太远，那里什么都有。他不听，转身深一脚浅一脚地进了田里，挖了几捧海菜装进袋子。

他塞给我说：“城里没有这个，带着吃。”

我伸手接过，沉甸甸的一大袋，薄薄的塑料袋几乎兜不住这份重量。

天快黑透了，我赶着末班车离开。

二叔送我到车前，我叮嘱他回去路上小心，他只是摆手催我上车。隔着车窗，我看见二叔站在昏黄的路灯下，笑着朝我挥手。我让他回去，他听不见，依然固执地站在光影里。

汽车发动，路灯的光晕在他周身渐渐发散。

我频频回头，直到车开远了，那盏路灯连同灯下的二叔，缩成了黑夜里一颗遥远的星星。

回过头，用袖子狠狠擦了把眼泪。

车窗外夜色如水，我知道，我真的到家了，也真的要走了。

你好，新的世界

Thu, 18 Dec 2025 00:00:00 GMT

这是终于重新上线的新博客，得益于数据丢失，彻底换成了静态博客，博客的所有内容都在本地，不会再依赖于任何服务器。也终于不怕丢数据了。再次怀念一下我的数据，那些记忆，那些情感，那些时间。从2013年开始到2025年的时间段，我经历了很多变化，也有很多情感，也有很多记忆。我会一直记得这些时间，这些情感，这些记忆。现在开始新的博客，新的开始。