npmstart.
开工台
开始一个项目

从 Astro
开始一个项目。

博客、文档、作品集。让内容先到,让交互按需加载。

什么时候选它?

适合内容占主导的网站,例如博客、产品文档和个人作品集。Astro 默认面向内容输出,也能在局部组件中引入交互。它与整页都由客户端应用控制的工作方式不同。

先准备开发环境

使用满足当前 Astro 要求的 Node.js 版本。向导中可以选择模板;本配方跳过自动安装,下一步显式安装依赖。

在新的项目父目录中打开终端,逐条运行命令。初始化向导出现问题时,以终端中的实际提示为准。

创建、安装、运行

下面使用 npm。其他包管理器可以在首页生成器切换;Yarn 命令以支持 dlx 的现代版本为前提。

终端命令
npx create-astro@latest my-app --no-install
cd my-app
npm install
npm run dev

跑起来之后,先改哪里?

编辑 src/pages/index.astro,尝试添加一个新页面。先用 Astro 组件组织内容,只有需要交互的部分再引入客户端组件。

什么时候考虑其他方案?

如果核心是频繁交互的工具或后台,可以从 React、Vue 或 Svelte 的 Vite 模板开始。

看看另一个起点

命令之外,也把需求写清楚。

选择一个场景,把第一版范围与验收标准一起准备好。

生成项目开工包

官方资料

Astro 入门文档