跳转到内容

创建你的第一个 Astro 项目

Get ready to…

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

创建新 Astro 站点的首选方法是通过我们的 create astro 设置向导。

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

    终端窗口
    # 使用 npm 创建新项目
    npm create astro@latest -- --template minimal
  2. 确认后安装 create-astro

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

  4. 当提示询问你是否安装依赖时,输入或选择 y

  5. 当提示询问你是否要初始化一个新的 Git 仓库时,输入或选择 y

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

在 VS Code 中打开你的项目

段落标题 在 VS Code 中打开你的项目
  1. 打开 VS Code。系统将提示你打开一个文件夹。选择你在安装向导期间创建的文件夹。

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

  3. 打开 VS Code 终端,可以看到类似如下提示:

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

你现在可以使用 VS Code 的内置的终端,而不是计算机自带的终端程序。

在开发模式下运行 Astro

段落标题 在开发模式下运行 Astro

为了实时预览项目,你需要在开发 (dev) 模式下运行 Astro。

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

    终端窗口
    npm run dev

    现在你应该能在终端中看到 Astro 正在以开发模式运行的提示信息。🚀

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

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

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

    以下是 Astro“初始项目”入门网站在浏览器预览中的样子:

    顶部带有 Astro 字样的空白白页。

Contribute

What’s on your mind?

Create GitHub Issue

Quickest way to alert our team of a problem.

Community