跳转到内容

通过自动命令行来安装 Astro

准备好安装 Astro 了吗?按照本指南开始使用 create astro CLI。

  • Node.js - v18.14.1 或更高版本。
  • 文本编辑器 - 我们建议使用安装有 Astro 官方扩展VS Code
  • 终端(Terminal) - Astro 可以通过其命令行界面 (CLI) 访问。

create astro 是从头开始新 Astro 项目的最快方式。它将引导你完成设置新 Astro 项目的每一步。 它允许你从几个不同的官方入门模板中进行选择,你也可以传递--template 参数来使用 GitHub 上的任何现有项目

在你的终端中运行以下命令以启动我们方便的安装向导:

Terminal window
# 使用 npm 创建一个新项目
npm create astro@latest

你可以在计算机上的任何位置运行 create astro,因此在开始之前无需为你的项目创建一个新的空目录。 如果你的新项目还没有空目录,该向导会帮你自动创建一个。

如果一切顺利的话,在一些建议的后续步骤之后,你应该会看到 “Liftoff confirmed. Explore your project!” 。 cd 进入你的新项目目录以开始使用 Astro。

如果你在 CLI 向导期间跳过了 npm install 步骤,请确保在继续之前安装你的依赖项。

Astro 带有一个内置的开发服务器,拥有项目开发所需的一切。 astro dev 命令将启动一个本地开发服务器,这样你就可以第一次看到你的新网站正在运行。

每个入门模板都带有一个预配置的脚本,可以为你运行 astro dev。 使用你最喜欢的包管理器运行此命令并启动 Astro 开发服务器。

Terminal window
npm run dev

如果一切顺利,Astro 现在应该可以在 http://localhost:4321/ 上为你的项目提供服务了!

Astro 将实时监听 src/ 目录中的文件更改,因此你在开发过程中进行更改时无需重新启动服务器。

如果你无法在浏览器中打开你的项目,请返回运行 dev 命令的终端并查看是否发生错误,或者检查你的项目的服务 URL 是否与​上方​链接的 URL 不同。

你还可以通过将 --template 参数传递给 create astro 命令,基于官方示例或者任何 GitHub 存储库的main 分支来启动一个新的 astro 项目。

Terminal window
# 使用官方示例创建一个新项目
npm create astro@latest -- --template <example-name>
# 基于某个 GitHub 仓库的 main 分支创建一个新项目
npm create astro@latest -- --template <github-username>/<github-repo>

默认情况下,此命令将使用模板仓库的main分支。要使用不同的分支,请将其作为 --template 参数的一部分传递:<github-username>/<github-repo>#<branch>

探索我们的主题和入门展示,你可以在其中浏览博客、个人作品集、文档、落地页等主题! 或者,在 GitHub 上搜索更多入门项目。

好了!你现在可以开始使用 Astro 进行构建了! 🥳

以下是我们建议接下来探索的几个主题。 你可以按任何顺序阅读它们。 你甚至可以暂时离开我们的文档,然后去玩你的新 Astro 项目代码库,遇到麻烦或有疑问时返回这里。

📚 添加框架:在我们的集成指南中学习如何使用 npx astro add 扩展 Astro 以支持 React、Svelte、Tailwind 等。

📚 部署你的网站:在我们的部署指南中了解如何构建 Astro 项目并将其部署到网络。

📚 了解你的代码库:在我们的项目结构指南中了解更多关于 Astro 项目结构的信息。