跳转到内容

创建你的第一个 Astro 项目

准备好去…

  • 运行 create astro 安装向导来创建一个新的 Astro 项目
  • 在开发(dev)模式下启动 Astro 服务器
  • 在浏览器中查看你网站的实时预览

创建一个新的 Astro 站点的首选方法是通过我们的 create astro 安装向导。

  1. 在终端的命令行中,使用你偏好的包管理器运行以下命令

    终端窗口
    # create a new project with npm
    npm create astro@latest
  2. 输入 y 来安装 create-astro

  3. 当提示询问你在哪里创建项目时,输入一个文件夹的名称来为你的项目创建一个新目录,例如 ./tutorial

  4. 你将会看到一个简短的入门模板列表以供选择。使用方向键(上和下)导航到 `minimal (empty)` 模板,然后按回车键(enter)提交你的选择。

  5. 当提示询问你是否要安装依赖时,输入 y

  6. 当提示询问你是否要初始化一个新的 git 仓库时,输入 y

当安装向导完成后,你就不再需要这个终端了。你现在可以打开 VS Code 继续。

  1. 打开 VS Code。你将被提示打开一个文件夹。选择你在安装向导期间创建的文件夹。

  2. 如果这是你第一次打开 Astro 项目,你应该会看到一个通知,询问你是否愿意安装推荐的扩展。点击查看推荐的扩展,并选择 Astro 语言支持扩展。这将为你的 Astro 代码提供语法高亮和自动补全功能。

  3. 确保终端是可见的,并且你可以看到命令提示符,例如

    终端窗口
    user@machine:~/tutorial$

现在你可以使用此窗口中内置的终端,而不是你计算机的终端应用程序,来完成本教程的其余部分。

为了在你工作时将项目文件作为一个网站来预览,你需要让 Astro 在开发(dev)模式下运行。

  1. 在 VS Code 的终端中输入以下命令来启动 Astro 开发服务器

    终端窗口
    npm run dev

    现在你应该在终端中看到确认信息,表明 Astro 正在开发模式下运行。🚀

你的项目文件包含了显示一个 Astro 网站所需的所有代码,但浏览器负责将你的代码显示为网页。

  1. 点击终端窗口中的 localhost 链接,查看你的新 Astro 网站的实时预览!

    (如果端口 4321 可用,Astro 默认使用 https://:4321。)

    这是 Astro “空项目” 入门网站在浏览器预览中应该看起来的样子

    A blank white page with the word Astro at the top.

贡献 社区 赞助