Blog

我第一次把网站部署上线,卡在了四道坎上

2026 年 7 月的一个晚上,我在浏览器里输入服务器 IP,回车之后等来一行 403 Forbidden。文件确实在,命令行里 ls 看得到,浏览器就是不给看。这篇把我从本地代码走到线上 HTTPS 服务的过程按「卡住的顺序」重写了一遍:GitHub 远程与 SSH key、文件权限与 www-data、Nginx 配置的四层结构和三种最简写法、502/504 与日志排查,以及后来省事的 certbot、GitHub Actions 和 GitHub MCP。配置片段和命令都可以直接复制。

fetch 一直返回 undefined,直到我把 HTTP 报文拆开看

我第一次用 fetch 调 GitHub API,控制台打出 undefined,而同一串 URL 粘进浏览器地址栏能看到完整的 JSON。这篇文章按我当时真正卡住的顺序重写了一遍 HTTP,从 Response 为什么要分两步读,到 404 为什么不进 catch,再到我用得最多的那几个 curl 标志、CORS 到底扣下了什么、自己写接口时路由为什么要同时比 method 和 url。所有 curl 命令都能直接复制。

部署这个网站时我踩的 7 个坑

用 Next.js 16 App Router + MDX 搭个人网站,从本地能跑到公网能访问,中间踩了 TypeScript 严格模式的 build 报错、中文文件名跨平台编码错乱、MDX 配置遗漏、路由组布局继承、draft/published 内容过滤、以及 Vercel 自动部署的「push即上线」风险。这篇把 7 个坑的完整因果链——从第一个报错到最终修复——全部记录下来,每个坑都附了错误信息、根因和修复方案。

硬盘坏掉那天,我重学了四件以为早就会的事

我刚开始工作那年改了一周代码,硬盘坏掉,没备份,也没远程仓库,一周的东西全没了。后来我学会用「最终版.docx」「最终版_改.docx」命名,文件名越来越长,心里的不安一点没少。这篇文章写的是那之后我回头补的四件事:文件到底放在哪、一个网址是怎么变成页面的、终端里在做什么、改坏了怎么退回去。路径、DNS 与三次握手、pwd 与 grep、Git 的三区模型和 stash,都是每天要碰的东西。

从 result 变量冲突到 setState,我把前端重新学了一遍

工作第一年我往一个 jQuery 老项目里加了变量 result,页面当场报错,排查三小时才发现别的文件里也有一个 result。从那次开始,我一路撞上四个卡点:全局作用域、浏览器不认 TypeScript、React 为什么会自动更新、state 该放在哪。这篇按我卡住的顺序,把模块化演进、npm 与 Vite、React 的数据流重新讲一遍。

搜索全站

输入关键词,查找项目与实践记录。