步骤 1：安装 Node.js#

•  Node.js 官网
• 下载并安装 LTS 版本（推荐 18.x 或 20.x）
• 验证安装：

1
node -v
2
npm -v

步骤 2：(推荐) 安装 pnpm#

Astro 也官方推荐使用 pnpm，性能更好：

1
npm install -g pnpm

验证：

1
pnpm -v

步骤 3：安装代码编辑器(自行安装)#

• 下载并安装 VS Code
• 在 VS Code 中安装 Astro 扩展：

步骤 4：创建并运行 Astro 项目(不带主题)#

1
# 创建新项目
2
 pnpm create astro@latest
3
 # 进入项目目录
4
 cd my-astro-project
5
 # 安装依赖
6
 pnpm install
7
 # 启动开发服务器
8
 pnpm dev

完成以上步骤后，你就可以在浏览器中访问 http://localhost:4321 看到你的 Astro 项目了

Astro 项目带主题(推荐)#

• 注册 GitHub账号
• matsuzaka-yuki/Mizuki 原作者仓库(可fork可不fork,我觉得fork会好点吧)

• 如果不fork如下：

1
git clone https://github.com/matsuzaka-yuki/mizuki.git
2
cd mizuki

• 安装依赖项：

1
pnpm install

• 启动开发服务器：

1
pnpm dev

https://docs.mizuki.mysqil.com/ 详细设置请跳转主题作者开发文档

• 查看是否安装rsync(本地)：

1
rsync --version

• 没有的安全如下：

1
brew install rsync  # Mac系统(其他系统自己问豆包)

• 登入服务器查看是否安装rsync(远程)：

1
rsync --version

• 稍微修改文件package.json,在13行下添加一条deploy

1
"build": "astro build && pagefind --site dist && node scripts/compress-fonts.js",
2
"deploy": "rsync -avz -e 'ssh -p 22 -i /Users/Desktop/key/1' ./dist root@IP:/www/wwwroot/wxh168.vip",

• 确认服务器有没有安全1panel或是宝塔面板

• 我以宝塔面板站点根目录为例:/www/wwwroot/wxh168.vip

• 最后一步

1
pnpm run build && pnpm run deploy

就这样,网站发布了…😊