当多个go源文件同属main包但未被同时编译时，即使函数首字母大写、包名一致，go run main.go仍会报“undefined”错误——因go默认仅编译显式指定的文件，需一并传入所有依赖文件或改用模块化包结构。
在Go语言中，同一包内的导出（首字母大写）函数本应可跨文件直接调用，但前提是这些文件必须被同时参与编译。你遇到的 ClearSession undefined 错误，并非因为作用域或可见性问题，而是由于执行命令 go run main.go 仅加载了 main.go 单个文件，而忽略了同属 package main 的 session.go ——Go不会自动扫描当前目录下所有 .go 文件。
✅ 正确解决方案一：显式指定全部源文件
go run main.go session.go
若还有 utils.go、handlers.go 等同包文件，也需一并列出：
go run main.go session.go handlers.go utils.go
✅ 正确解决方案二（推荐）：重构为独立子包（更工程化）
将 session 相关逻辑抽离为 session 子包，提升可维护性与复用性：
project/
├── main.go
└── session/
├── session.go
├── validations.go
└── errors.gosession/session.go 示例：
立即学习“go语言免费学习笔记（深入）”；
package session
import "net/http"
// ClearSession 清除用户会话
func ClearSession(w http.ResponseWriter, r *http.Request) {
// 实现逻辑，如清除 Cookie 或服务端 Session 数据
http.SetCookie(w, &http.Cookie{
Name: "session_id",
Value: "",
MaxAge: -1,
})
}main.go 中导入并使用：
package main
import (
"net/http"
"your-module-name/session" // 注意：需先初始化 Go 模块（go mod init your-module-name）
)
func logout(w http.ResponseWriter, r *http.Request) {
session.ClearSession(w, r) // ✅ 现在可安全调用
http.Redirect(w, r, "/", http.StatusFound)
}
func main() {
http.HandleFunc("/logout", logout)
http.ListenAndServe(":8080", nil)
}? 关键前提：使用子包前需在项目根目录运行 go mod init your-module-name 初始化模块，否则 import "session" 会被视为相对路径导入（已弃用），导致编译失败。
⚠️ 注意事项
- go run *.go 在简单场景下可用，但不推荐用于生产项目（易遗漏文件、不可控顺序）；
- 同包多文件是合法且常见的，但 go run 不支持通配符隐式包含（Go 1.22+ 仍保持此行为）；
- 函数导出仅取决于首字母大写 + 同包可见性，与文件物理位置无关；但编译器必须“看到”该函数定义所在的源文件；
- 若使用 IDE（如 VS Code + Go extension），确保工作区已识别为 Go 模块，否则代码补全和诊断可能失效。
通过显式编译或合理分包，即可彻底解决跨文件函数不可见问题——前者适合原型验证，后者是构建可扩展Go服务的标准实践。
