Surge是一个强大的工具，用于自动化前端部署，简化了静态网站和应用的部署流程。以下是详细的Surge使用教程，帮助您快速上手

安装Surge

安装Surge,可以通过以下命令：

npm install -g surge

或者使用Yarn：

yarn global add surge

初始化项目

创建一个项目目录,进入该目录并运行：

surge init

这会生成一个 surge.json 文件,配置如下：

{
  "project": "your-project-name",
  "server": {
    "port": 80,
    "root": "dist/",
    "domain": "yourdomain.com"
  }
}

准备发布内容

确保项目目录包含静态文件（如HTML、CSS、JS、图片等），建议使用构建工具（如Webpack、Gulp）优化和压缩文件。

构建并推送

运行以下命令构建并推送到Surge：

surge build

这会将构建好的文件推送到Surge服务器。

发布到Surge

在Surge上发布,按照以下步骤操作：

1. 运行 surge publish 或 surge push。
2. 选择或输入项目名称,Surge会提供一个链接供您查看。

配置高级功能

• 多环境配置： 在 surge.json 中添加多个环境配置，

  {
    "project": "your-project-name",
    "env": {
      "prod": {
        "domain": "yourdomain.com"
      },
      "dev": {
        "domain": "yourdevdomain.com"
      }
    }
  }

• 持续集成： 结合GitHub Actions，自动化测试和部署流程，创建 surge.json 中的 scripts 部分,设置自动化测试步骤。

使用示例

假设项目结构如下：

your-project/
├── index.html
├── style.css
├── script.js
├── assets/
│   └── logo.png
└── dist/
    └── index.html

运行以下命令：

surge init

编辑 surge.json，设置 dist 为根目录：

{
  "project": "your-project",
  "server": {
    "port": 80,
    "root": "dist/",
    "domain": "yourdomain.com"
  }
}

构建并推送：

mkdir -p dist && npm run build && surge build

解决常见问题

• 服务器未响应：检查网络连接或权限问题。
• 配置错误：重新审视 surge.json 文件。
• 安全性：设置访问控制列表（ACL）,防止未授权访问。

命令行选项

• --production：仅在生产环境发布。
• --preview：预览发布内容后再发布。
• --gc：自动清理旧版本。

通过以上步骤，您可以轻松使用Surge进行前端部署,节省时间并提高效率。