前提条件

Node.js: 确保你的系统上已经安装了 Node.js，推荐使用 v16 及以上版本。
           npm 或 yarn: Node.js 的包管理工具。你可以选择其中之一进行后续操作。

安装 Astro CLI

npm install -g astro
yarn global add astro

创建新项目

在命令行中运行以下命令以全局安装 Astro CLI：
           在命令行输入：

astro create my-website
cd my-website

安装依赖

进入你的新创建的项目目录后，运行安装脚本来获取所有必要的库和工具：

npm install
yarn install

开始编写内容与代码

Astro 使用 Markdown 文件来编写内容页面。创建或编辑 `.md` 或 `.astro` 文件以添加页面或组件。

配置文件： `astro.config.mjs` 是一个 JavaScript 模块，用于定义项目的基本设置。例如，你可以在这里配置预处理器、插件等。

编写页面与组件：创建或编辑 `.md` 或 `.astro` 文件以添加页面或组件。这些文件通常放置在 `src/pages/` 目录中。

---
title: "Hello, Astro"
---

# 欢迎来到我的网站！

这是一个使用 Astro 构建的静态站点。

使用模板和插件

Astro 支持多种预处理器如 Handlebars、Pug 等，你可以根据需要选择一种并使用相应的语法来编写组件。此外，可以通过安装额外的插件来增强功能。

运行与构建项目

在开发模式下启动项目：Astro 会实时重新加载浏览器：

npm run dev
yarn dev

这样你可以直接在浏览器中查看你的页面更改效果。

构建与部署：当你准备好发布站点时，可以使用以下命令进行构建操作：

npm run build
yarn build

这将会生成一个适合部署的静态文件夹（通常位于 `dist` 目录下）。你可以将这个文件夹上传到任何静态网站托管服务上，如 GitHub Pages、Netlify 等。

总结

通过以上步骤，你应该已经成功安装并启动了一个 Astro 项目。Astro 提供了简洁且强大的工具链来帮助你快速构建现代的静态站点应用。如果你遇到任何问题或需要更详细的文档支持，请访问官方文档：Astro 官网。