安装 Surge

你需要在 Mac 上安装 Surge,可以通过以下步骤进行安装：

1. 使用 Homebrew：

   • 如果你已经安装了 Homebrew，可以使用以下命令安装 Surge：

     brew install surge

2. 手动下载：

   • Homebrew 未安装，可以直接下载 Surge 的 dmg 文件并安装：
     • Surge 官网：https://surge.sh
     • 下载完成后双击安装文件,按照指引完成安装。

初始化 Surge 项目

在终端中进入你的项目目录，初始化 Surge 项目：

1. 进入项目目录：

   cd path/to/your/project

2. 初始化 Surge 项目：

   surge init

   这会生成一个 surge.json 文件,用于存储你的部署配置。

安装 Surge CLI

Surge 提供了一个命令行工具（Surge CLI），用于构建和部署项目,安装方法如下：

1. 使用 npm 或 yarn：

   npm install -g surge-cli

   或者：

   yarn global add surge-cli

配置 Surge 项目

修改 surge.json 文件,添加你的部署配置。

{
  "branch": "master", // 部署分支（默认为 master）
  "prefix": "/", // 部署路径（默认为 root）
  "domain": "your-domain.surge.sh", // 你的域名
  "static": "public", // 静态文件目录
  "command": "npm run build", // 预建命令（可选）
  "external": true // 是否启用 HTTPS
}

构建项目

运行以下命令构建项目并部署到 Surge：

surge build

• 参数：
  • --domain: 指定部署的域名。
  • --prefix: 指定部署路径。
  • --external: 启用 HTTPS。

部署项目

运行以下命令将项目部署到 Surge：

surge publish

• 参数：
  • --branch: 指定分支（默认为 master）。
  • --message: 添加 commit 消息。

访问部署项目

部署完成后,你可以通过以下方式访问项目：

1. 直接打开 Surge 生成的链接：

   • Surge 会生成一个链接，https://your-domain.surge.sh。

2. 在浏览器中直接打开：

   将生成的链接复制到浏览器中,查看部署结果。

本地预览

如果你希望在本地预览项目,可以使用以下命令：

surge serve

• 参数：
  • `--path**: 指定静态文件目录。
  • `--host**: 指定域名。

多次部署

如果你需要多次部署，可以重复运行 surge publish 命令，每次都会生成新的 Surge 提供的链接。

使用 Surge CLI 命令

Surge 提供了多种 CLI 命令,常用的包括：

• surge init：初始化 Surge 项目。
• surge build：构建项目。
• surge publish：部署项目。
• surge serve：本地预览项目。

配置文件解释

• branch: 部署分支，默认为 master。
• prefix: 部署路径，默认为 。
• domain: 域名，建议提前注册（如通过 Namecheap 或 Cloudflare）。
• static: 静态文件目录。
• command: 预建命令，用于构建项目（如 npm run build）。
• external: 是否启用 HTTPS。