go build 报 undefined symbol 或 dynamic library not found 是因运行时缺失系统动态库，需用 ldd 定位缺失库、按发行版包管理器精确安装并执行 ldconfig 刷新缓存；CGO_ENABLED=0 可避免依赖但要求代码无 C 调用。
go build 报 undefined symbol 或 dynamic library not found
这不是 Go 代码或模块配置问题，而是编译出的二进制在运行时找不到系统级动态库。典型现象是：./myapp: error while loading shared libraries: libwebp.so.5: cannot open shared object file: No such file or directory 或更隐蔽的 undefined symbol: WebPDecodeRGB。这类错误只在 go build 后执行二进制时触发，go run 不会暴露——因为后者走的是源码解释路径，不链接系统库。
- 先用
ldd ./myapp | grep "not found"精准定位缺失库名（如libwebp.so.5），不是路径，也不是版本号后缀 - 在目标环境（比如 Docker 容器、生产服务器）上运行
ldd，本地开发机结果不可靠 - 用
apt search libwebp.so.5（Debian/Ubuntu）或dnf provides "libwebp.so.5"（RHEL/CentOS/Fedora）查对应包名，严格匹配.so.x中的数字（libwebp.so.5→libwebp7，不是libwebp8） - 装完必须跟
ldconfig，否则新库不会被动态链接器识别——这是容器里最常漏掉的一步
CGO_ENABLED=0 能绕过所有系统库依赖吗
能，但有前提：你的代码没调用任何 C 语言接口。只要源码里出现 #include、import "C" 或使用了 cgo 标记（比如 // #include <openssl/ssl.h>），关掉 CGO_ENABLED 就会直接编译失败。
- 纯 Go 标准库（
net/http、encoding/json）和纯 Go 第三方库（如golang.org/x/net/http2）不受影响 - 常见踩坑点：用了
github.com/mattn/go-sqlite3、go.etcd.io/bbolt（部分构建变体）、gocv等带 C 依赖的库，关 CGO 后无法编译 -
CGO_ENABLED=0 go build -o myapp生成的二进制是静态链接的，可直接扔进 Alpine 或无 libc 环境运行 - 若必须用 Cgo，优先考虑多阶段构建：编译阶段用完整镜像（如
golang:1.23），运行阶段用debian:slim并显式apt install所需库
go mod download 卡住但报错指向系统库
不会。系统库缺失不会导致 go mod download 卡住——它只做网络请求和文件解压，不加载任何动态库。如果你看到 go mod download 卡住或报 no such host、dial tcp timeout，那一定是代理或 DNS 问题，和系统库完全无关。
Colly Golang Web Scraper and Crawler Framework
下载
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
- 检查
go env GOPROXY是否设为国内可用地址，如https://goproxy.cn,direct - 确认没误设
GOPROXY=https://proxy.golang.org（国内基本不可达） -
go mod download失败时输出里绝不会出现libssl.so.1.1或undefined symbol这类词——那是go build或运行时才有的错误 - 如果
go build成功但运行失败，再回头查系统库；如果go mod download失败，别浪费时间补libwebp7，先修网络
容器里 ldd 显示 all found，但运行仍报 not found
大概率是 LD_LIBRARY_PATH 被污染或 ldconfig 缓存未更新。容器启动时动态链接器不会自动扫描新装库，除非你显式刷新缓存。
立即学习“go语言免费学习笔记（深入）”；
- 不要用
ENV LD_LIBRARY_PATH /usr/lib/x86_64-linux-gnu这类硬编码路径——不同发行版库路径不同，且易覆盖系统默认搜索顺序 - 正确做法是在
RUN指令里连写安装与刷新：RUN apt update && apt install -y libwebp7 && ldconfig - 验证是否生效：在容器内运行
cat /etc/ld.so.cache | strings | grep webp，能看到libwebp.so.5才算真正注册成功 - Alpine 镜像要用
apk add libwebp，且注意其库名是libwebp.so.7，和 Debian 的.so.5不兼容——跨镜像构建时必须对齐
.so 名字，在不同 Linux 发行版里可能属于完全不同的软件包，甚至主版本号都不同；而 ldd 只告诉你“缺什么”，不告诉你“该装哪个包”。必须结合发行版包管理器精准匹配，不能靠经验猜。 
