从零开始:用 AstroWind 搭一个中文网站
一条命令创建项目,认识目录结构,改掉站点信息与首页文案,写下第一篇文章,最后构建并部署到静态托管。
快速开始
不想先看特性?直接把模板跑起来,两分钟后你就能开始改内容。
$ bunx create-astro@latest --template arthelokyo/astrowind按提示创建项目,运行 bun install 与 bun run dev,打开 localhost:4321,看到的演示站就是你自己的代码。需要 Bun 1.4.4 或更高版本。
仓库自带 AGENTS.md 与 16 个分步技能文档,Claude Code、Cursor、Codex 等工具能直接看懂目录约定,帮你加页面、改主题、关博客。
客户项目、个人站点、公司官网都可以用。不必保留署名,也无需付费;如果它帮你省下一个下午,去 GitHub 点个 Star 就好。
核心特性
一套面向生产环境的静态站点骨架:性能、SEO、内容与组件都已在模板里就位,你只需要换成自己的文案与图片。
静态优先的 Astro 搭配 CSS-first 配置的 Tailwind v4,几乎不向浏览器发送 JavaScript,页面又快又好改。
Hero、特性、Bento、价格对比、FAQ、客户评价、团队、时间线、图库等区块全部带类型定义,按需拼装即可。
Markdown / MDX 文章放在 src/data/post/,自动获得 RSS、分类、标签、相关文章、社交分享与阅读时长。
按路由生成 sitemap,默认配置 OG / Twitter 卡片、robots 与 JSON-LD,PageSpeed Insights 四项满分。
深浅主题、RTL、shadcn/ui 兼容的设计变量;本地图由 Sharp 优化,远程图交给 Unpic 走 CDN。
AGENTS.md、CLAUDE.md 与 .agents/skills/ 把常见改造任务写成分步指南,让 AI 改代码有据可依。
模板内部
站点名、URL、SEO、博客开关与分析都写在 src/config.yaml,由自研 Astro integration 编译成虚拟模块 astrowind:config。
src/pages/ 下的 .astro 与 .md 文件自动成为路由,动态路由负责博客列表、文章、分类与标签。
src/content.config.ts 用 glob() 加载器读取 src/data/post/ 下的文章,构建时完成校验与渲染。
CustomStyles.astro 定义明暗两套 CSS 变量,tailwind.css 用 @theme 暴露设计 token,改一处即可全局换肤。
首页、落地页、博客页与 Markdown 页各有一套布局,区块组件可以任意组合成新的版式。
从手机到大屏都有一致的阅读体验,移动端菜单、图片尺寸与间距都已处理妥当。
内置图片、视频、社交嵌入组件,配合 Astro 资源管线自动压缩与懒加载。
导航栏、页脚、面包屑、分页、标签、分享按钮这些重复工作,模板已经写好并且带类型。
output: static 产出 dist/ 纯静态文件,Vercel、Netlify、Cloudflare Workers、nginx 容器都能直接托管。
v1 处于维护模式,持续接收依赖升级与问题修复,Astro 与 Tailwind 大版本更新也会跟进。
1,300+ 次提交、1700+ fork,加上 16 个 AI 技能文档,遇到问题几乎总能找到参考。
第 1 步:获取模板
在 GitHub 上 fork 或点击 Use this template,也可以用上面的命令直接创建项目。整个代码库立刻属于你。
第 2 步:替换内容
改 src/config.yaml 里的站点信息与 logo,替换首页与 src/data/post/ 里的示例文字,把图片换成自己的素材。
第 3 步:调整外观
在 CustomStyles.astro 改明暗主题颜色,在 astro.config.ts 的 fonts 配置里换字体,用现成区块重新拼装页面。
完成,可以上线了
组件库
每个区块都是带类型 props 的 .astro 组件,页面只是把它们的顺序和文案组合起来
桌面下拉菜单、移动端折叠菜单、主题切换、RSS 入口与多栏页脚。
标题、副标题、行动按钮与主视觉,支持多种排版变体。
网格、Bento、标签页、步骤与时间线,把能力讲清楚。
图文左右分栏、引用、注释与图库,承载长篇说明。
CTA、公告条、粘性按钮与订阅表单,把读者导向下一步。
价格卡片与功能对比表,适合 SaaS 与产品页。
评价、社会证明、数据统计与品牌墙,建立信任感。
联系表单、团队介绍、项目展示与常见问题折叠面板。
文章卡片、列表、分页、标签、相关文章与 RSS 输出。
项目历程
从 Astro 1.0 beta 时代起步,跟随每一次大版本演进,也由社区的贡献者一点点打磨。
最初只有几个页面和少量区块,思路却很明确:网站可以同时做到快、简单、好看。
年底登上 Astro 生态榜首,此后连续多年保持这一位置,第一批来自陌生开发者的 PR 也陆续到来。
内容集合、图片优化、页面过渡相继加入,区块数量翻倍,博客逐渐成型。
跟随 Astro 4 更新,大部分提交来自贡献者:可访问性、工具链、编辑与部署方式的改进。
升级 Astro 5,提交节奏放缓但没有停,Star 数在 10 月突破五千。
一年内跟进两个框架大版本:新一代区块、完整落地页示例、更像文档的博客,以及写给 AI 助手的指南。
首次提交四年后,演示站里不再有占位内容:每个页面、每篇示例文章都是真实的。
这几篇文章从安装、定制讲到模板原理与 AI 协作,按需要挑一篇开始即可。所有示例文章都放在 src/data/post/,构建时自动进入列表、分类、标签与 RSS。
一条命令创建项目,认识目录结构,改掉站点信息与首页文案,写下第一篇文章,最后构建并部署到静态托管。
把演示站的蓝色和 Inter 换成你自己的品牌:需要改动的文件其实只有五个,都不用碰组件内部实现。
看懂 AstroWind 内部:config.yaml 如何变成虚拟模块、路由与固定链接怎么生成、文章如何被读取、图片与元信息如何处理。
为什么这个模板特别适合 AI 协作,AGENTS.md 写了什么,.agents/skills/ 里有哪些现成任务指南,以及怎样让改动保持可审查。
FAQ
在克隆仓库之前最常被问到的几个问题。更复杂的操作步骤,仓库里的 .agents/skills/ 已经写成了分步指南。
一个基于 Astro v7 与 Tailwind CSS v4 的免费开源静态站点模板:包含页头页脚、30+ 可复用区块、Markdown/MDX 博客、暗色模式、RTL、图片优化、SEO 元信息与 RSS,改完内容即可部署到任意静态托管。
Bun 1.4.4 或更高版本(packageManager 中已固定)和一个终端。运行 bunx create-astro@latest --template arthelokyo/astrowind,再 bun install 与 bun run dev。站点信息在 src/config.yaml,颜色字体在 src/components/CustomStyles.astro。
可以。把 src/config.yaml 里的 apps.blog.isEnabled 设为 false,博客路由、RSS 与文章区块都会从构建产物中消失,其余部分不受影响。
颜色是 CustomStyles.astro 里的明暗两套 CSS 变量;字体在 astro.config.ts 的 fonts 配置里通过 Astro Fonts API 自托管;Logo 是 src/components/Logo.astro。这些变量同时喂给 shadcn/ui 兼容的设计 token。
仓库自带 AGENTS.md 约定与 .agents/skills/ 下 16 个分步技能(关博客、换 OG 图、子路径部署、接 CMS、部署 Cloudflare 等),Claude Code、Codex、Cursor 都能按指南可靠完成任务。
任何能托管静态文件的地方:Vercel、Netlify、Cloudflare Workers、GitHub Pages、nginx 容器(仓库自带 Dockerfile)或自己的服务器。模板采用 MIT 许可,个人与商业项目都免费。
免费、开源、生产可用。
克隆下来,换成你的内容,然后部署。