Surge 是一个非常流行的工具，用于轻松部署静态网站和前端应用程序。以下是使用 Surge 的详细步骤指南

安装 Surge

确保你已经安装了 Node.js 和 npm 或 Yarn，然后安装 Surge：

npm install -g surge

或者使用 Yarn：

yarn global add surge

初始化项目

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

mkdir my-project
cd my-project

初始化 Surge 项目并初始化 git 仓库：

surge init
git init -b main

安装依赖项

安装项目所需的所有依赖项,

npm install

或者如果你使用 React 或类似的框架，可以添加相关的构建工具：

npm install react react-dom

配置 Surge 项目

在项目根目录下找到或创建 surge.json 文件：

{
  "project": {
    "name": "my-project",
    "description": "My Surge Project",
    "author": "Your Name"
  },
  "git": {
    "remote": "git@github.com:yourusername/my-project.git",
    "branch": "main"
  },
  "surge": {
    "pages": ["./pages/**"],
    "框架": "exponent",
    "环境": {
      "node": "16.x",
      "前端": "React"
    }
  }
}

确保 surge.json 中的配置正确，包括 git 远程和分支信息，以及你需要部署的文件路径。

preparing 项目文件

• 静态文件：将所有静态文件（如 HTML、CSS、JavaScript、图片等）放入项目根目录。

• 动态文件：如果你的项目使用服务器（如 Express），则需要添加一个 server.js 文件，或者如果使用前端框架，可能需要使用 conect.json 或其他构建工具。

• 构建工具：根据需要安装构建工具，

  npm install -g connect

部署项目

在终端运行以下命令：

surge push

Surge 会自动读取 surge.json 文件并将项目部署到 Surge 的服务器上，你可以在浏览器中访问你的项目：

your-project.surge.sh

配置域名（可选）

如果你有自己的域名,配置 DNS 记录将域名指向 Surge 生成的 URL：

@   IN   A
your-project.surge.sh.   IN   A   192.168.1.1

使用环境变量

在 surge.json 中添加环境变量部分：

{
  "环境": {
    "变量名": "值"
  }
}

然后在代码中使用这些环境变量。

部署后管理

• 使用 surge push 更新项目。
• 使用 surge list 查看正在运行的项目。
• 使用 surge delete 删除项目。
• 使用 surge rename 重命名项目。

常见问题

• 403 Forbidden 错误：检查 git 仓库的读写权限，确保你有推送权限。
• 构建错误：检查构建工具和依赖是否正确安装。
• 域名配置错误：确保 DNS 记录正确无误。

进一步优化

• 使用 Surge 的静态分析工具优化构建速度。
• 使用 surge build 选项构建项目以减少构建时间。

通过以上步骤,你可以轻松使用 Surge 部署静态网站和前端项目，遇到问题时，检查 surge.json 配置和 git 仓库设置，确保一切正确无误。