1. 依赖管理不规范：未使用Go Modules或依赖未锁定
在Debian上打包Golang项目时，依赖管理是常见隐患。部分开发者可能仍使用过时的dep工具或手动管理vendor目录，导致依赖版本冲突或构建不一致。正确做法是使用Go Modules（Go 1.11+官方推荐），通过go mod init初始化项目，go get添加依赖，go mod tidy清理未使用的依赖，并利用go.sum锁定依赖哈希值，确保跨环境构建的一致性。
2. 忽略CGO的影响：未正确处理CGO_ENABLED环境变量
若项目依赖CGO（如使用C库），交叉编译或打包时未禁用CGO可能导致生成的二进制文件无法在目标Debian系统上运行（如缺少C库依赖）。正确做法是在打包时显式设置CGO_ENABLED=0，强制使用纯Go编译，避免C依赖问题；若必须使用CGO，则需确保目标系统安装了对应的C库开发包（如libc6-dev）。
3. 环境变量配置错误：GOROOT、GOPATH或PATH未正确设置
Debian系统上，GOROOT（Go安装路径）、GOPATH（工作空间路径）和PATH（可执行文件搜索路径）配置错误会导致编译或安装失败。例如，GOPATH未包含项目目录会导致go build找不到依赖，PATH未包含Go的bin目录会导致无法执行go命令。正确做法是通过export GOROOT=/usr/local/go（若手动安装）、export GOPATH=$HOME/go、export PATH=$PATH:$GOROOT/bin:$GOPATH/bin配置环境变量，并通过source ~/.bashrc应用更改。
4. 交叉编译环境变量遗漏：未指定GOOS和GOARCH
Debian系统可能用于构建不同架构的二进制文件（如amd64、arm64），若未设置GOOS（目标操作系统）和GOARCH（目标架构），默认会构建当前系统的架构，导致无法在目标设备上运行。正确做法是在打包命令中明确指定目标环境，例如GOOS=linux GOARCH=amd64 go build -o myapp（构建Linux amd64架构二进制文件）。
5. 文件权限问题：生成的二进制文件无执行权限
打包后的Debian软件包中，可执行文件若未设置执行权限，用户安装后无法直接运行。正确做法是在打包前通过chmod +x myapp为二进制文件添加执行权限，或在debian/rules文件中添加权限设置步骤。
6. 版本不匹配：Go工具链与标准库版本冲突
混用不同版本的Go工具链（如通过apt安装的系统Go与手动下载的Go）或标准库，会导致“对象版本不匹配”错误（如import /path/to/pkg/linux_amd64/fmt.a: object is [version] expected [version]）。正确做法是彻底清理系统中的旧版Go（如sudo apt remove golang-go），使用官方推荐的安装方式（如sudo apt install golang-go或手动下载二进制包），并通过go env检查GOROOT和GOPATH是否指向正确路径。
7. Debian包元数据不完整：control或copyright文件缺失
Debian包要求包含debian/control（软件包名称、版本、依赖项）和debian/copyright（版权信息）等元数据文件，若缺失会导致debuild命令失败或生成的包无法正常安装。正确做法是参考Debian官方文档创建完整的debian目录结构，确保control文件包含Package、Version、Depends（依赖项，如libc6）等字段，copyright文件包含软件许可信息（如MIT、Apache 2.0）。
