全站加速
全站加速
- 文档首页
全站加速开发指南IGA Pages 构建指南
文档反馈
问问助手IGA Pages 提供自动化的构建与部署流程。当代码推送到关联的 Git 仓库或通过控制台手动触发时，平台会自动执行依赖安装、项目构建和部署上线。本文档说明如何触发构建、配置构建参数以及平台支持的包管理器。
触发构建（Git Push 与手动触发）
IGA Pages 支持以下两种方式触发构建与部署：
方式 | 触发条件 | 适用场景 |
|---|---|---|
Git 推送 | 执行 | 日常开发，持续集成 |
控制台手动部署 | 在 IGA Pages 控制台进入项目详情，点击 新建部署 | 需要手动控制发布节奏，或排查问题时重新部署 |
说明
Git 推送触发的构建为全自动流程，推荐作为主要的部署方式。
构建配置
框架自动检测机制
IGA Pages 会根据项目结构自动检测所使用的框架，并应用对应的默认构建命令与输出目录。各框架的默认值请参见IGA Pages 框架指南中的前端框架表格。
自定义构建命令与输出目录
当默认配置不满足需求时，可通过以下两种方式自定义：
配置方式 | 入口 | 优先级 |
|---|---|---|
| 项目根目录下创建 | 高（优先生效） |
控制台设置 | 进入项目详情，在 项目设置 > 构建配置 区域配置 | 低 |
注意
当 iga.json 与控制台配置同时存在时，iga.json 中的配置优先级更高，会覆盖控制台设置。iga.json 中未填写的字段将沿用控制台配置或框架默认值。
iga.json 配置字段说明
iga.json 放置于项目根目录，所有字段均为可选。示例如下：
{ "installCommand": "pnpm install", "buildCommand": "vite build", "outputDirectory": "dist" }
各字段含义：
字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
|
| 依赖安装命令。不指定时 CLI 根据 lock 文件自动检测包管理器并执行安装。 |
|
|
| 项目构建命令。不指定时使用控制台配置或框架默认值。 |
|
|
| 构建产物输出目录。不指定时使用控制台配置或框架默认值。 |
|
包管理器支持（npm / pnpm / yarn）
IGA Pages 通过识别项目根目录中的 lock 文件来确定所使用的包管理器。支持情况如下：
包管理器 | Lock 文件 | 支持版本 |
|---|---|---|
npm |
| 10 |
pnpm |
| 7 / 8 / 9 / 10 |
yarn |
| 1 / 2 |
说明
请确保项目中只保留一个 lock 文件，避免包管理器检测冲突。
构建环境（Node.js 运行时与环境变量）
IGA Pages 构建环境的基本信息：
项目 | 说明 |
|---|---|
运行时 | Node.js（具体版本取决于项目配置） |
默认流程 | 安装依赖（ |
环境变量 | 可通过控制台 项目设置 配置构建时所需的环境变量 |
如需在本地复现构建流程或进行调试，可使用 IGA Pages CLI 的 iga pages dev 命令启动本地开发服务器，详见IGA Pages CLI 使用手册。