打包操作指南

更新时间：2026-08-21 16:21:28 阅读：39 收藏：0 收藏
# 打包操作指南

> **读者**：已安装程序并写好 `.cspk.*.json` 的客户。  
> 说明日常如何打包与自检；不包含厂商构建本工具的过程。

## 开始前

1. 确认程序能正常进入主菜单并执行打包。
2. 工作目录中已有合法配置，例如 `.cspk.default.json`。见 [配置文件说明](/doc-39)。
3. 确认 `include` 路径在 `base_dir` 下真实存在。

## 方式一：交互菜单

1. 运行程序进入主菜单。
2. 选 `1`。
3. 从列表选择配置序号，或按 `n` 新建后再编辑、再打包。
4. 成功后终端会打印生成的 zip 完整路径。

## 方式二：命令行指定配置

在配置文件所在目录（或使用配置的相对/绝对路径）执行：

```text
# Windows（以实际程序名为准）
程序名.exe .cspk.default.json

# Linux / Mac（已安装 cpk 时）
cpk .cspk.default.json
```

适合脚本、CI 或固定发布流水线调用。

## 方式三：Windows 右键

1. 在主菜单注册右键菜单（若该项可用）。
2. 在资源管理器中右键 `.cspk.*.json`，选择 **Custom-Pack**。
3. 按提示完成打包。

## 产出文件名

输出形如：

```text
{output_name}_{base目录名}_{yyyyMMdd_HHmmss}.zip
```

例如：`release_myproject_20260821_161000.zip`，位于配置的 `output_dir`。

## 打包后自检

- [ ] zip 能正常打开
- [ ] 应包含的目录/文件都在
- [ ] 不应包含的内容（`.git`、密钥、过大日志等）已排除
- [ ] 体积与预期大致相符（异常偏大时检查 `include: ["."]` 与 exclude）

## 检查更新

```text
程序名.exe --update
# 或
cpk --update
```

若有新版本会下载更新包，按终端提示完成安装后重新启动程序。无网环境请从产品页手动下载对应版本替换。

## 常见失败原因

| 提示/现象 | 原因与处理 |
|-----------|------------|
| 未指定包含项(include) | 配置里 `include` 为空，至少写一项 |
| 配置JSON无效 | 检查括号、逗号、引号；去掉非法注释 |
| 基础目录不存在 | `base_dir` 路径错误 |
| 功能提示暂不可用 | 按产品页或供应商说明处理 |
| 仅支持 `.cspk.*.json` | 文件名不符合规则 |

相关文档：

- [配置文件说明](/doc-39)
- [问题采集清单](/doc-42)
评论区
