Linux安装Go必须用官方二进制包解压至/usr/local/go，配置GOROOT和PATH，禁用系统包管理器；http.FileServer需配合http.StripPrefix且路径末尾斜杠不可省，否则404。
直接用官方二进制包解压到 /usr/local/go，配好 GOROOT 和 PATH 就能跑起来；文件服务器用 http.FileServer + http.StripPrefix 是最稳的组合，但路径写错或少个斜杠立刻 404。
Linux 上装 Go 必须手动解压官方包，别碰系统包管理器
Ubuntu 的 apt install golang 或 CentOS 的 yum install golang 给的通常是 go1.18 甚至更老版本，不支持 embed.FS、泛型完善度差，且 go mod 行为和现代项目不兼容。必须从 https://www.php.cn/link/c3367c02da318284045c5b13c76a79d2 下载最新版（比如 go1.23.10.linux-amd64.tar.gz）：
- 用
sudo tar -C /usr/local -xzf go*.tar.gz解压，结果是/usr/local/go - 写入
/etc/profile.d/golang.sh（不是~/.bashrc），内容只有两行：export GOROOT=/usr/local/goexport PATH=$GOROOT/bin:$PATH - 执行
source /etc/profile.d/golang.sh，再跑go version和go env GOROOT确认输出一致 - 如果后续要
go install工具（如gopls），再加一行export GOPATH=$HOME/go并把$GOPATH/bin加进PATH
http.FileServer 直接用会 404，关键在 StripPrefix 和 Dir 路径写法
下面这段代码看似合理，但访问 /static/logo.png 一定 404：
http.Handle("/static/", http.FileServer(http.Dir("./static")))
问题出在两点：
立即学习“go语言免费学习笔记（深入）”；
-
http.FileServer不自动剥离 URL 前缀，请求/static/logo.png会被当作文路径./static/static/logo.png去找 -
http.Dir("./static/")末尾带斜杠，filepath.Clean可能意外归一化出错；必须写成http.Dir("./static")（不带尾斜杠）
正确写法只有一行：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
http.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.Dir("./static"))))
注意 StripPrefix 第二个参数末尾的 / 不能省——它表示“把前缀连同斜杠一起切掉”，否则 /static/css/main.css 会变成 static/css/main.css（缺开头斜杠，路径失效）。
想让 / 自动返回 index.html，得靠请求路径结尾是否带 /
http.FileServer 默认支持 index.html，但有个硬性条件：请求路径必须以 / 结尾。也就是说：
- 访问
http://localhost:8080/→ 查./public/index.html→ 成功返回 - 访问
http://localhost:8080（无尾斜杠）→ 查./public这个“文件” → 404 - 访问
http://localhost:8080/static/→ 查./static/index.html→ 成功 - 访问
http://localhost:8080/static→ 查./static文件 → 404
所以前端路由或 Nginx 反代时，务必确保静态资源请求带尾斜杠；如果必须支持无斜杠跳转，得自己写中间件重定向，http.FileServer 不处理这个。
生产部署前必须检查三件事：权限、路径、Content-Type
本地能跑 ≠ 部署后能用。常见卡点：
-
stat ./static看目录是否对运行用户（如www-data）可读；403 多半是这里卡住 - 用绝对路径代替相对路径：
http.Dir(filepath.Join(os.Getenv("PWD"), "static"))，避免os.Chdir或 systemd 工作目录切换导致路径错乱 - Alpine 或最小化镜像常缺
/etc/mime.types，导致.css被当成text/plain；可在 handler 外包一层，对已知后缀手动设Content-Type，例如.js→application/javascript
最易忽略的是：Go 1.16+ 的 embed.FS 不能直接传给 http.Dir，得用 http.FS(yourEmbedFS) 包一层——否则编译过、运行时报 panic。
