
这不是写给程序员的教程
如果你已经会写代码,建一个个人网站并不稀奇。真正难的是另一件事:让一个普通人第一次看到 Cloudflare、Netlify、GitHub、终端、构建命令这些词时,不立刻关掉页面。
这组教程想解决的就是这个问题。
你需要的前提很少:
- 会用手机和电脑。
- 能下载、移动、重命名文件。
- 愿意把自己的介绍、作品、照片或文章整理出来。
- 愿意在 Codex 改完文件后,自己打开页面读一遍。
你不需要先学会写代码。你也不需要在第一天理解“静态站”“DNS”“仓库”“部署流水线”这些词。它们会在真正需要时再出现。
为什么现在可以让普通人试一试
过去建站像搬家:你要先知道房子怎么盖、线路怎么接、水管怎么走。
现在更像整理一个房间:你先把东西放进一个文件夹,告诉 Codex 你想要怎样的房间,它帮你搭架子、放柜子、检查门能不能打开。你仍然要决定哪些东西能公开、哪些东西不能公开,但不必自己从木板开始做。
OpenAI 的官方 Codex Quickstart 当前把 Codex 分成 App、IDE extension、CLI 和 Cloud 几种入口;官方 CLI 文档也说明,Codex CLI 是一个可以在本地终端运行、在选定目录里读取、修改和运行代码的 coding agent。
这句话对普通人最重要的部分不是“coding agent”,而是 选定目录。
你给 Codex 哪个文件夹,它就主要围绕哪个文件夹工作。所以教程的第一步不是注册域名,也不是发到网上,而是在一个空目录里启动 Codex。目录结构、页面文件和本地预览,先让 Codex 来处理。
先别把网站想得太大
很多人一想到“个人网站”,脑子里会立刻冒出很多东西:
- 要不要买域名?
- 要不要做得很漂亮?
- 要不要博客、相册、评论、会员、订阅?
- 要不要像大公司官网一样?
第一版都不需要。
普通人的第一座个人网站,只要回答三个问题:
- 我是谁?
- 我想长期展示什么?
- 别人怎么联系我或继续了解我?
所以第一版可以很小:
- 首页:一句话介绍你是谁。
- 关于页:多说几句你的背景和现在关注的事。
- 作品或文章列表:放你愿意公开的内容。
- 联系页:放一个邮箱或公开社交链接。
如果你是设计师,第一版就是作品集。如果你是老师,第一版就是资料和文章。如果你是家长,第一版可以是经过审核的家庭学习记录。如果你是工程师,第一版可以是项目和教程。
这组教程怎么读
不要把它当成一本厚书一次读完。你应该按阶段完成。
第一阶段,只做本地版本:
完成这两步以后,你应该已经能在自己的电脑上看到一个个人网站雏形。它可能不好看,也不完整,但你会知道:这个东西不是玄学,它就是一组文件和页面。
第二阶段,才考虑免费发布:
- 用平台提供的免费地址先发布出来。
- 不急着买域名。
- 先确认你愿意更新这个网站。
第三阶段,再考虑长期维护:
- 要不要买自己的域名。
- 要不要绑定统计。
- 要不要把文章同步到公众号、小红书、DEV.to、Bluesky 等平台。
- 要不要增加中英文版本、作品分类、图片管理和备份。
你要把 Codex 当成什么
不要把 Codex 当成一个“万能建站按钮”。那样你很容易失望。
更好的理解是:它是一个会读文件、会改文件、会跑检查、会解释改动的助手。
你负责说清楚:
- 网站给谁看。
- 第一版要有哪些页面。
- 哪些材料可以公开。
- 哪些东西必须保密。
- 改完之后怎么验收。
Codex 负责做那些机械、细碎、容易出错的事:
- 建目录。
- 写页面。
- 统一样式。
- 补标题、描述和图片说明。
- 跑构建。
- 提醒可能的隐私风险。
这个分工很重要。网站最终代表你,不代表 Codex。它可以帮你加速,但不能替你决定什么内容值得公开。
第一条指令应该怎么写
很多人第一次会这样说:
帮我做一个个人网站。
这句话太空。Codex 只能猜。
更适合普通人的第一条指令是:
我想做一个个人网站,但我不是程序员。
请先不要改文件,先帮我检查当前文件夹里有什么。
然后给我一个最简单的网站方案。
目标读者:第一次看到我的朋友、合作对象或未来雇主。
第一版只需要:首页、关于页、作品或文章列表、联系页。
请提醒我哪些内容不应该公开。
确认方案后,再开始创建文件。
注意这里有两个关键点:
- 先检查,再改文件。
- 先提醒隐私,再公开内容。
这能降低很多不必要的恐惧。你不是把电脑完全交出去,而是在一个明确的文件夹里,让 Codex 一步一步做事。
你应该期待什么结果
第一天的目标不是“做出一个惊艳全网的网站”。
第一天只需要达到这个标准:
- 你知道网站文件放在哪里。
- 你知道哪些材料没有被放进公开目录。
- 你看到一个能打开的首页。
- 你知道下一次要改哪几句话、哪几张图。
如果做到这些,这个教程就已经起作用了。
因为恐惧会从“我完全不知道这是什么”变成“我知道下一步问什么”。对普通人来说,这个变化比多学十个技术名词更重要。
