在 Debian 上写 Go 程序并不难，真正容易出问题的往往不是语法，而是环境变量、平台相关代码和测试习惯。下面按“先把环境跑通，再把代码写稳，最后确认能在不同系统上正常运行”的顺序整理一遍，读完你可以判断哪些步骤是必须做的，哪些地方最容易埋下跨平台隐患。
在 Debian 上先把 Go 环境装好
如果只是先把开发环境搭起来，最直接的办法就是使用 Debian 自带的软件包：
sudo apt update
sudo apt install golang-go这样安装快、维护也省事，适合先把编译链路跑通。若你需要更新的版本，可以直接前往 Go 官网下载并手动安装，但无论采用哪种方式，后面的环境变量检查都建议做一遍。
GOPATH 和 GOROOT 为什么要检查
安装完成后，先确认 GOPATH 和 GOROOT 是否已经配置好。很多 Debian 环境会自动处理，但手动确认一次能避免后续编译、包管理或命令找不到路径的问题。
echo $GOPATH
echo $GOROOT
# 如果没设置，手动补上
export GOPATH=$HOME/go
export GOROOT=/usr/local/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin这里可以这样理解：
GOROOT对应 Go 本身的安装位置。GOPATH主要用于工作目录和相关工具链路径。PATH里补上二者的bin路径后，Go 命令和安装的工具才能直接调用。
如果这一步没处理好，后面即便代码没问题，也可能在构建阶段遇到不必要的环境错误。
写跨平台代码时，先避开两个常见坑
Go 天生具备良好的跨平台能力，但前提是代码本身不要主动依赖某个系统的专有行为。实际编写时，最值得优先注意的是下面两点：
- 尽量使用标准库提供的跨平台能力，避免直接依赖特定平台的库或 API。
- 如果业务确实离不开平台差异，就使用条件编译（build tags）拆分实现。
用 build tags 区分不同平台实现
当 Linux 和 Windows 需要分别处理时，可以直接按平台拆文件或拆实现。原理就是在编译阶段让 Go 自动选择匹配的代码。
例如：
// +build linux
package main
import "fmt"
func main() {
fmt.Println("Running on Linux")
}// +build windows
package main
import "fmt"
func main() {
fmt.Println("Running on Windows")
}这样在对应平台编译时，Go 会选择符合条件的代码块。对于必须处理系统差异的程序，这种方式比在运行时硬写分支更清晰，也更适合后续维护。
如何构建应用，以及交叉编译要注意什么
在项目目录中，最基本的构建命令就是：
go build -o myapp这条命令会生成可执行文件 myapp。需要注意的是，它默认构建的是当前系统和当前架构对应的版本，也就是你在 Debian 当前环境下直接能运行的产物。
如果目标是其他操作系统或架构，就不能只停留在这一步，还需要设置 GOOS 和 GOARCH 环境变量来做交叉编译。原文没有展开具体命令，但这里至少可以先建立一个判断：go build -o myapp 解决的是本机构建，跨平台发布则要额外处理目标平台参数。
为什么跨平台程序一定要在目标系统上测试
很多 Go 程序在本机能编译通过，并不等于跨平台就没有问题。尤其是下面这些细节，往往要到真实环境里才会暴露出来：
- 路径分隔符差异
- 换行符差异
- 文件系统行为差异
- 依赖库在不同平台上的兼容性
所以构建完成后，不要只在 Debian 本机验证一遍就结束。至少要在目标操作系统上实际运行一次，确认程序入口、文件读写和输出行为都符合预期。
一个最小项目结构和示例程序
如果你只是从零开始练手，一个典型的 Go 项目结构可以先保持简洁：
myapp/
├── main.go
├── go.mod
└── go.sum这个结构已经足够支撑一个基础的跨平台命令行程序。
最小示例：输出当前运行平台
下面这段代码适合作为最小验证样例。它通过 runtime.GOOS 输出当前操作系统名称，可以快速确认程序是否按预期运行：
package main
import (
"fmt"
"runtime"
)
func main() {
fmt.Printf("Hello, World! I am running on %s\n", runtime.GOOS)
}这段程序虽然简单，但很适合用来做第一轮环境自检：能否成功编译、是否能在不同系统启动、输出的平台信息是否正确，一眼就能看出来。
把 Debian 上的 Go 跨平台开发流程串起来
整套流程可以概括为四步：先安装 Go，再确认 GOPATH 和 GOROOT，接着尽量用标准库写可移植代码，必要时用 build tags 区分平台实现，最后通过构建和真实环境测试确认结果。只要这几个环节不跳步，Debian 上的 Go 跨平台开发基本就能稳定起步。
