更新时间：2026-08-21 16:21:28 | 阅读：40 | 收藏：0 收藏 # Linux / Mac 使用指南 > **读者**：在 Linux 或 macOS 上使用 Custom-Pack-Tool 官方程序的客户或运维。 > **不包含**：源码编译、交叉构建、发版上传。 ## 你需要准备什么 | 项目 | 说明 | |------|------| | 系统 | 常见 64 位 Linux，或 macOS | | 程序 | 产品页提供的对应操作系统 / 架构官方程序 | | 权限 | 打包无需 root；安装全局命令 `cpk` 需要管理员（sudo） | | 网络 | 检查更新时需要联网；日常打包可离线 | 请下载与本机架构匹配的包（如 `amd64` / `arm64`），不要混用。 ## 安装与启动 1. 解压或复制官方程序到固定目录，例如 `~/bin/Custom-Pack-Tool`。 2. 赋予执行权限： ```bash chmod +x ./你的程序文件名 ``` 3. 直接运行进入交互菜单，或查看帮助： ```bash ./你的程序文件名 ./你的程序文件名 -h ``` ## 安装全局命令 `cpk`（推荐） 在主菜单选择（若该项可用）： - `4` 安装 Linux/Mac `cpk` 命令 - `5` 卸载 Linux/Mac `cpk` 命令 安装会在 `/usr/local/bin/cpk` 创建指向当前程序的软链接（需确认并可能输入 sudo 密码）。 安装成功后可在任意目录使用： ```bash cpk # 启动交互菜单 cpk -h # 帮助 cpk --update # 检查更新 cpk .cspk.xxx.json # 按配置打包 ``` 说明：命令别名固定为 `cpk`，避免与系统里其它打包工具混淆。 ## 主菜单说明 | 选项 | 作用 | |------|------| | `1` | 选择配置文件打包 | | `4` / `5` | 安装 / 卸载 `cpk`（仅非 Windows；以菜单实际可用性为准） | | `0` | 退出 | Windows 上的右键菜单项在 Linux/Mac 不可用，请使用 `cpk` 或交互菜单。 ## 验收清单 - [ ] 程序可执行，`-h` 显示版本与用法 - [ ]（可选）已安装 `cpk`，任意目录可调用 - [ ] `cpk .cspk.default.json`（或你的配置）能打出 zip ## 常见问题 | 现象 | 处理 | |------|------| | `Permission denied` | `chmod +x` 后再运行 | | 安装 `cpk` 失败 | 确认有 sudo；检查 `/usr/local/bin` 是否可写 | | `cpk: command not found` | 确认软链接存在，或重新打开终端；检查 PATH 是否含 `/usr/local/bin` | | 某功能提示暂不可用 | 按产品页或供应商说明处理 | 相关文档： - [配置文件说明](/doc-39) - [打包操作指南](/doc-40) 评论区
