Surge 是一个快速部署工具，专注于静态网站和 API 的快速上线。以下是一个基本的 Surge 教程，帮助你快速上手

安装 Surge

安装 Surge，可以通过以下命令安装（mac 或 Linux）：

curl -o- https://raw.githubusercontent.com/surge/sh/master/scripts/install.sh | sh

初始化项目

创建一个新目录,并进入其中：

mkdir myproject && cd myproject

创建 Surge 配置文件

创建 surge.yaml 文件,配置你的项目信息：

project:
  name: myproject
  version: 1..

部署你的项目

在项目根目录下运行以下命令：

surge init

提交代码

将你的项目提交到 Git 仓库，然后部署到 Surge：

git add .
git commit -m "初始提交"
git push origin master
surge deploy

访问你的项目

Surge 提供了免费的域名和静态网站托管，你可以通过以下 URL 访问你的项目：

https://yourproject.surge.sh

配置自定义域名

如果你有自定义域名，配置 surge.yaml：

project:
  name: myproject
  version: 1..
  domain: example.com

部署后,更新配置并重新部署：

surge deploy --update

集成 CI/CD

将 Surge 集成到你的 CI/CD 流程中，使用 GitHub Actions：

name: deploy
on:
  push:
    runs: true
  pull_request:
    runs: true
jobs:
  deploy:
    name: Deploy to Surge
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v2
      - name: Deploy to Surge
        uses: surge/sh-action@v2

高级功能

• 多环境部署：在 surge.yaml 中添加环境配置。
• 静态分析：Surge 提供静态文件分析,帮助你优化性能。

常见问题

• 如果域名配置错误，检查 surge.yaml 是否正确。
• 部署失败可能是因为 Git 提交内容变化或网络问题。

Surge 使得部署静态网站和 API 轻松简单，适合开发者快速上线需求，通过以上步骤，你可以快速上手并开始使用 Surge。