零基础搭建 Docusaurus 个人网站指南
这份指南不是写给程序员的，是写给“想拥有自己数字花园”的人。你不会在中间看到 React、框架、路由这些词。你只会看到你需要的步骤——从什么都没有，到它在那里跑着。
如果你在任何一个步骤卡住了，直接把问题扔给 AI 大模型就行。把报错信息复制给它，告诉它你想做什么，它会告诉你改哪个文件、哪一行、改成什么样。你不是在“学”，你是在“用”。
一、为什么是 Docusaurus，不是在线建站平台
市面上大多数建站工具——Wix、Squarespace、Webflow、Cargo、Google Sites——都是在线拖拽式平台。你在上面搭出一个页面，花时间调整样式，感觉那是你的网站。但本质上你是在租用他们的系统，你的内容是以“数据库记录”或“页面状态”的形式存在他们的后台里，而不是以纯文本文件的形式长在你的硬盘上。
如果你有一天不想续费了，或者平台改规则了，你拿回来的可能是一个导出的 HTML 压缩包，或者一堆格式混乱的页面记录。你很难搬去别的地方重建。
而 Docusaurus 是“买下来的地”。所有文件都长在你的电脑上，.md 和 .mdx 格式，完全由你控制。哪天你想换框架，所有文章可以直接搬走；哪天你想离线整理，随时可以打开修改。你不依赖网络，也不依赖任何平台的脸色。
你嫌懒可以用那些在线平台，甚至直接不做。但现在 AI 能写代码了，搭建本地站点的门槛已经很低。花几个小时把环境跑起来，你得到的是一个完全属于你自己的数字空间，不需要看任何人的脸色。
二、前置准备
你需要两样东西：
- 一台能联网的电脑
- 一个域名（可选）——没有可以先不用买，后面再说
不需要提前学任何编程语言。你只需要知道：你在给自己建一个“能放东西的地方”。
三、第一步：装 Node.js
Docusaurus 需要 Node.js 才能跑。你不需要理解它是什么，只需要装好，让它在那里。
- 打开 Node.js 官网，下载 LTS 版本（稳定版）
- 一路“下一步”安装完成
- 安装完成后，打开“命令提示符”或“终端”
- 输入
node -v，如果看到版本号，说明它已经装好了
四、第二步：拉一个 Docusaurus 项目
在终端里输入下面的命令：
# 创建一个 Docusaurus 项目
npx create-docusaurus@latest my-website classic
# 进到项目文件夹里
cd my-website
# 在本地跑起来
npm run start
浏览器会自动打开 http://localhost:3000，你会看到一个默认的页面。这说明你的网站已经在自己电脑上跑起来了，不需要上传到任何服务器。
这个步骤可能会花一点时间，因为它在下载依赖。你可以在这段时间去喝杯水，或者看看窗外的树。
⚠️ 如果你是 Windows 用户，请注意：
不要把这个项目放在 C 盘里跑。C 盘是系统盘，权限限制多，Node.js 项目放里面容易因为权限问题报错，而且会拖慢系统。建议放在 D 盘、E 盘或其他非系统盘，比如建一个
D:\my-website这样的目录。如果你不确定怎么操作，直接问 AI：“我想把 Docusaurus 项目放在 D 盘，该怎么做？”它会告诉你每一步怎么走。
五、第三步：改配置文件
网站跑起来之后，所有的配置都集中在 docusaurus.config.js 这个文件里。你不需要理解它怎么工作的，只需要找到对应的位置，改成你的信息：
| 你想改的 | 找这个字段 |
|---|---|
| 网站标题 | title: |
| 网站描述 | tagline: |
| 导航栏 | navbar 下面的 items |
| 页脚 | footer 下面的 copyright |
| 图标 | favicon: |
改完之后保存，浏览器会自动刷新，你会看到变化。
六、第四步：放内容
Docusaurus 的内容都放在这几个目录里：
| 目录 | 用来放 |
|---|---|
blog/ | 文章（.md 或 .mdx 文件） |
docs/ | 按目录整理的结构化内容 |
src/pages/ | 你自己做的页面（比如关于页、声音页） |
你不需要理解“路由”是什么。你只需要知道：你在 blog/ 里新建一个 .md 文件，它就会自动变成一个可以被访问的页面。
如果你需要增加其他的页面，或者修改导航栏、页脚、主题色等配置，直接问任意 AI 大模型就行。把你想改的地方告诉它，它会告诉你改哪个文件、哪一行、改成什么样。
你不是在“学 Docusaurus”，你是在“用 Docusaurus”。学不完的东西，让 AI 帮你处理。你需要做的只是告诉它你想达到的效果。
七、第五步：部署到服务器
当你把本地内容都整理好之后，运行下面这个命令：
npm run build
Docusaurus 会把所有内容打包成静态文件，放在 build/ 文件夹里。你只需要把 build/ 里的所有文件上传到你的服务器，然后在服务器那边配置好域名解析，网站就能被访问了。
如果你没有自己的服务器，也可以用免费的托管平台（Vercel、Netlify、GitHub Pages），它们会自动从你的代码仓库里读取内容并上线。上传方式很多，选一个你觉得最顺手的就行。
八、这套路径能帮你做到什么
当你走完一遍，你会得到一个：
-
你自己拥有的、有独立域名的网站
-
一个完全属于你的、可以持续生长的空间
-
所有内容都是纯文本文件，不会因为平台改规则而丢失
-
你随时可以导出、迁移、备份、恢复
你不需要成为程序员才能拥有它。你只需要愿意花几个小时，把第一块砖放好。剩下的，在时间里慢慢长。
九、附：服务器怎么选（轻量版）
你不需要买一台“真正的服务器”。你只需要一台轻量应用服务器，它像一台专门给你跑网站的小主机，不用管底层硬件，只管放网站就行了。国内主流云厂商都有这类产品，我用的腾讯云轻量应用服务器，你也可以参考。
选国内还是海外？
| 地区 | 优点 | 麻烦的地方 |
|---|---|---|
| 国内服务器 | 访问快、稳定 | 需要ICP备案，要等几天，还要在网站底部挂备案号 |
| 海外服务器 | 不用备案，买了就能用 | 通常更贵，国内访问可能会慢一点 |
如果你愿意等几天，建议选国内。备案流程不复杂，但确实要多等几个工作日。等备案下来之后，你的网站才算正式“落定”了。
（当然你要干坏事，当我没说。）
代理的事
现在代理链路比较复杂，如果你对“代理”不了解，建议直接自己去官网买，不用找人代购。腾讯云、阿里云官网都有轻量服务器的购买入口，跟着指引走就行。
选配置的时候，选最基础的那档就够用了（1-2核CPU、2-4GB内存、几十GB硬盘），价格大约几十块一个月。你的网站是静态站，不需要高性能配置。
一点提醒
如果你选国内服务器，记得在网站底部挂上备案信息（ICP备案号和公安联网备案号），不然会被查。可以把这个提醒直接写进你的待办清单里。
服务器是花园的“土地”。你不需要知道它怎么运作，只需要知道它在就行。
这是你实际走过的路。现在它也变成了别人的路。
🍜🐔