验证golang环境安装成功需三步：运行go version确认版本，执行go env检查goroot和gopath路径无空格/中文，再用go run hello.go测试编译运行；同时确保cgo_enabled=1且ffmpeg已正确安装并加入path。
直接上手就行，Golang环境本身不依赖音视频编译能力——它只是调用外部工具（比如 ffmpeg）或链接 C 库（如 libav），关键在路径、权限和二进制兼容性。
Go 环境安装与验证必须做这三件事
别跳过校验步骤，很多后续“转码失败”“找不到命令”问题都源于此：
- 用官方二进制包安装（不是通过包管理器如
apt install golang），避免旧版本或缺失cgo支持 - 确认
go env GOPATH和go env GOROOT路径不含空格或中文，否则某些音视频库（如github.com/u2takey/ffmpeg-go）构建会静默失败 - 运行
go env CGO_ENABLED，输出必须是1；若为0，说明禁用了 C 互操作，所有依赖libav/ffmpegC API 的 Go 包（如gocv、goav）将无法工作
ffmpeg 不是 Go 包，而是必须独立部署的系统级依赖
Go 代码里写的 exec.Command("ffmpeg", ...) 是在 shell 层调用可执行文件，不是导入模块。常见卡点：
-
exec: "ffmpeg": executable file not found in $PATH：不是 Go 错误，是 Linux 找不到命令。检查which ffmpeg，确保其路径已加入$PATH（推荐软链到/usr/local/bin/ffmpeg） - 用 Docker 部署时，基础镜像（如
golang:1.22-slim）默认不含ffmpeg，需显式apt-get install -y ffmpeg或使用多阶段构建 - Windows 上注意：Go 进程默认以当前用户权限启动子进程，若
ffmpeg.exe被杀毒软件拦截，cmd.Run()会卡住或返回exit status 3221226356（即 0xC0000409，堆栈溢出），此时要加cmd.SysProcAttr = &syscall.SysProcAttr{HideWindow: true}
需要 cgo 的音视频库编译失败，本质是头文件或链接路径不对
例如用 goav（封装 libav）或 gocv（OpenCV）时，报错类似 fatal error: libavcodec/avcodec.h: No such file or directory：
- Linux 下：先装开发包，不是只装
ffmpeg，而是apt-get install libavcodec-dev libavformat-dev libswscale-dev libavutil-dev - macOS 下：
brew install ffmpeg默认不装头文件，需额外brew install ffmpeg --with-libvpx --with-libx264（新版 Homebrew 已弃用该 flag），更可靠的是brew install ffmpeg pkg-config+ 确保pkg-config --modversion libavcodec可返回版本 - 交叉编译（如从 macOS 编译 Linux 二进制）时，
cgo会尝试链接本地头文件，但目标系统 ABI 不同，必然失败；必须用目标平台的 sysroot 或容器内编译
真正麻烦的从来不是“怎么装”，而是“哪个组件在哪个环节查哪份头文件、连哪个动态库、用哪个 ABI 版本”。调试时优先看 pkg-config --cflags libavcodec 和 ldd ./your-binary | grep av 的输出，比重装十遍环境更有效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
