Work

我的零基础建站个人主页心路历程

经验记录
踩坑复盘
个人里程碑

记录我从零开始,克服各种恶心的系统报错,最终成功把个人作品集部署到全网的真实经历。

默认配图

1. 为什么会有这个网站?

一直以来,我想赚米,但是我不知道自己能干啥,我看别人说我是高敏感低精力人群,干不了大事,我就开始学了点软件,七七八八的啥都会点啥都不精通,完事我想着先搞个个人网站,到时候我再把作品一个个堆进来,到时候也方便别人知道我。同时不依附于任何社交平台,能自由地定义它的长相,展示我最真实的作品和经历

于是我直接几乎零基础开始暴力建站

2. 破除迷茫和踩坑实录:事前准备与系统报错的搏斗

在写第一行代码之前,我花了不少时间去理解现代前端开发的“工具链”想要把一个网站做出来并挂到网上,我主要准备了这四样东西:

🛠️ 本地干活的软件(装在电脑上)

  • Node.js (网页的发动机): 以前我以为浏览器就能运行一切,后来才知道要在本地电脑上测试现代网站,必须装这个环境。它就像汽车的引擎,没它网站跑不起来
  • VS Code (程序员的精装工作台): 这是微软出的代码编辑器。它不仅能给代码上色、提示错误,更牛的是它里面自带了一个“终端(Terminal)”,可以直接在这里给电脑下达底层指令

☁️ 云端存放的基地(注册的账号)

  • GitHub (代码的云端保险箱): 注册这个网站,是为了给我的代码找个家。它相当于程序员版的“百度网盘”,不仅能把代码存到云端防丢失,还能记录我每一次修改的历史
  • Vercel (24小时不休的超级管家): 代码存在 GitHub 上别人是看不到网页的。注册 Vercel 并把它和 GitHub 绑定,是为了让它当我的免费服务器。只要 GitHub 上的代码一更新,Vercel 就会自动帮我把网站打包并发布到全世界都能访问的网址上

搞清楚工具的作用后,我使用了 Astro 框架的模板开始建站。原本以为只要在终端里敲几行命令就能搞定,结果却迎来了 Windows 系统的疯狂“毒打”:

当我在 VS Code 终端敲下 npm run dev(启动服务器指令)时,直接爆出红色的 spawn EPERM 权限错误。排查半天发现,因为我的代码文件夹建在了桌面上,而桌面被微软自带的 OneDrive 实时云同步“锁死”了,导致底层打包引擎 esbuild 抢不到文件控制权。 解决办法: 将项目文件夹彻底搬迁到 C 盘根目录(C:\projects),脱离云盘的魔爪。

为了解决报错,我需要删除庞大的 node_modules 文件夹重新安装。但系统疯狂提示文件被占用,无法删除。这是由于 Windows 后台有残留的“丧尸进程”死死咬住了文件夹。 解决办法: 我先尝试用 taskkill 命令强杀进程,最后直接祭出“重启电脑”的物理超度大法,重启后用 Shift+Delete 强制粉碎了旧文件,再重新执行 npm install,世界终于清静了。

本地环境彻底跑通,并换上我的专属大头照和名字后,迎来了最激动的“发射”环节。

  1. 本地盖章: 在 VS Code 的源代码管理里,输入“初次建站完成”,点击“提交 (Commit)”。(因为界面一度卡死,我甚至学会了用终端代码 git add .git commit -m "init" 强行提交)。
  2. 推上云端: 点击“发布分支”,我的代码瞬间飞到了之前注册好的 GitHub 私有仓库里。
  3. 全网自动部署: 登录 Vercel,导入我的 GitHub 仓库,点击蓝色的 Deploy。由于之前授权打通了,剩下的工作全是全自动的。

大概等了一分钟,屏幕上飘落满屏的 Congratulations 彩纸。那一刻,属于我的全球唯一网址正式诞生。

“所谓的资深程序员,其实就是比新手多解决了几千个报错而已。” 今天,我完成了我的第一次 Debug

3. 完成时刻

当我敲下 npm run dev,看到绿色的 localhost:4321 亮起;当我把代码推送到 GitHub,看着 Vercel 全自动构建,最后成功,我牛大了

接下来,我会更新我的成长和新的作品。敬请期待!