golangci-lint在Linux上运行需满足三点：二进制在PATH中（如$HOME/go/bin需手动加入）、.golangci.yml与go.mod同级且缩进正确、Go环境与CI一致（GO111MODULE=on、go version≥1.16）。
golangci-lint 在 Linux 上能跑起来，核心就三件事：二进制得在 PATH 里、配置文件得放对位置、Go module 环境得和 CI 一致。本地能跑但服务器上 command not found 或者一堆 undefined: xxx，八成卡在这三个地方中的某一个。
golangci-lint 命令找不到？PATH 没配对
Linux 下装完不等于能用。官方脚本默认装到 $(go env GOPATH)/bin，但这个目录大概率不在你的 PATH 里。
- 先确认 GOPATH：
go env GOPATH（常见是$HOME/go） - 检查 PATH 是否包含该路径：
echo $PATH | grep -o "$HOME/go/bin"—— 如果没输出，就得加 - 编辑
~/.bashrc或~/.zshrc，追加一行：export PATH=$PATH:$HOME/go/bin - 执行
source ~/.bashrc（或对应 shell 配置文件），再试golangci-lint --version
别信“装完就自动可用”——Linux 服务器常以最小化安装，PATH 不会自动补全。
.golangci.yml 放哪？项目根目录是唯一有效位置
golangci-lint 只认当前工作目录下的 .golangci.yml，不会向上递归查找父目录。CI 脚本里如果 cd 错了路径，配置就失效。
- 必须放在 Git 仓库根目录，和
go.mod同级 - 内容别写错格式：YAML 对缩进敏感，
enable:和- govet必须对齐，不能用 tab - 推荐显式
enable，别混用disable：enable清晰可控，disable容易漏掉新加入的 linter - 加上
skip-dirs: [vendor, testdata, mocks]，避免扫描无关目录拖慢速度
服务器上跑 golangci-lint run 前，先 pwd 看一眼当前路径是不是项目根目录。
Linux 安全审计工具，检查 SSH 配置、开放/监听端口、防火墙规则（ufw/iptables/nftables）、失败登录尝试、sudoers 权限...
CI 里报 undefined？不是 lint 问题，是 Go 环境没对齐
本地 OK、服务器报 undefined: http.HandlerFunc 这类错误，基本可以确定是 Go module 解析失败，和 linter 本身无关。
- 确认 CI 使用的 Go 版本 ≥ 1.16：
go version，旧版默认关闭 module 模式 - 强制开启 module：
go env -w GO111MODULE=on（CI 脚本里加这一行） - 检查
go.mod是否已提交，有没有漏掉replace指向本地路径（CI 拉不到） - 运行一次
go build ./...看是否成功 —— 如果它都过不了，golangci-lint必然失败
golangci-lint 依赖 Go 的 type checker，它不是纯文本扫描器。环境不一致时，它连 AST 都构不出来。
CI 流水线中怎么跑才不卡住？超时和缓存必须设
默认 golangci-lint run 会遍历所有文件、启用全部 linter，大型项目可能卡死或超时。
- 加
--timeout=2m，防止无限 hang 住（GitHub Actions 默认超时 6m，但早断早好） - 跳过非源码目录：
--skip-dirs vendor,testdata,generated - 启用缓存：设环境变量
GOLANGCI_LINT_CACHE=/tmp/golangci-cache，并确保该路径可写、跨 job 复用 - CI 主流程别用
--fast：它会跳过unused等耗时检查，容易漏掉真实问题
最常被忽略的是缓存路径权限 —— /tmp 下的目录可能被清理，或者不同 runner 用户写入权限不一致，导致缓存失效却无提示。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
