核心是确保代码能在目标机编译、运行并长期存活：需在含go.mod目录执行go build，避免gopath冲突；用官方go二进制而非系统包；systemd服务必须显式配置user/group、environment和workingdirectory。
直接部署 Golang 项目，核心不是“装环境”，而是让代码能在目标机器上编译、运行、长期存活。本地开发环境配得再好，部署时漏掉 GOPATH 冲突、go mod 路径错误或 systemd 服务配置里少写一行 Environment=，都会导致启动失败。
go build 之前必须确认 go.mod 和工作目录位置
现代 Go 项目依赖 go mod 管理，但它的行为严格绑定当前目录和 go.mod 文件路径：
-
go build必须在包含go.mod的目录下执行；若在子目录运行，会报错no Go files in ...或找不到主模块 - 模块名（
module example.com/myapp）必须与实际路径一致；比如模块名是github.com/user/project，但你把代码 clone 到/opt/myapp，go build仍能成功，但go run .可能因导入路径不匹配而失败 - 避免在
$GOPATH/src下新建项目再go mod init—— 这会导致模块路径自动推导为src/xxx，后续 import 全乱套
Linux 服务器上部署时别依赖系统自带的 go 包
CentOS/RHEL 的 yum install golang 通常版本老旧（如 1.16），而生产项目往往要求 1.21+；用它编译可能遇到：
-
go: unexpected module path "xxx"：新版语法（如泛型、embed）不被识别 -
cannot use _ as value：Go 1.20+ 对空白标识符的语义收紧，旧工具链不兼容 - 更麻烦的是：
yum安装后GOROOT指向/usr/lib/golang，而手动解压的官方包默认在/usr/local/go，两者混用极易导致go env输出混乱
建议统一用官方二进制包：wget https://go.dev/dl/go1.22.5.linux-amd64.tar.gz → sudo tar -C /usr/local -xzf go*.tar.gz → 配置 /etc/profile 中的 GOROOT 和 PATH。
systemd 服务文件里最容易漏掉三件事
用 systemd 托管 Go 服务看似简单，但以下三项缺一不可：
-
User=和Group=必须显式指定非 root 用户（如www-data），否则进程以 root 运行，os.UserHomeDir()返回/root，读不到普通用户下的.env或证书文件 -
Environment=要逐个写，不能只靠EnvironmentFile=-/etc/default/myapp—— 如果该文件不存在，-前缀虽可忽略，但常见误写成EnvironmentFile=/etc/default/myapp导致启动失败且日志只显示Failed at step EXEC spawning -
WorkingDirectory=必须设为项目根目录（含go.mod），否则os.ReadFile("config.yaml")会报no such file or directory，因为 Go 默认从进程启动路径读取相对路径
调试远程服务时 dlv attach 比本地 run 更可靠
线上服务出问题，别急着 go run main.go 本地复现——环境差异（DNS、TLS 证书、数据库连接池）会让问题消失。更有效的方式是：
- 用
go build -gcflags="all=-N -l" -o myapp main.go编译带调试信息的二进制（-N -l关闭优化） - 把
myapp和dlv一起上传到服务器（dlv可静态编译：GOOS=linux GOARCH=amd64 go install github.com/go-delve/delve/cmd/dlv@latest） - 运行
dlv exec ./myapp --headless --listen :2345 --api-version 2 --accept-multiclient，再用 VS Code Remote-SSH 连接调试
注意：如果服务已用 systemd 启动，先 sudo systemctl stop myapp，否则 dlv exec 会提示端口被占或权限拒绝——dlv 不能 attach 到 systemd 管理的进程，除非启用 Delegate=yes 并调大 LimitNOFILE，这反而增加复杂度。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
