企业🤖AI Agent构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
Golang 包结构 :所有代码都必须组织在 package 中。 ~~~ • 源文件头部以 "package <name>" 声明包名称。 • 包由同一目录下的多个源码文件组成。 • 包名类似 namespace,与包所在目录名、编译文件名无关。 • 目录名最好不用 main、all、std 这三个保留名称。 • 可执行文件必须包含 package main,入口函数 main。 ~~~ 说明:os.Args 返回命令行参数,os.Exit 终止进程。要获取正确的可执行文件路径,可用 `filepath.Abs(exec.LookPath(os.Args[0]))`。 package 基本的管理单元: 同一个package下面,可以有非常多的不同文件,只要每个文件的头部 都有 如 "package xxx" 的相同name 就可以 在主方法中使用 xxx.Method()调用不同文件中的方法了。 文件夹名字可以和这个package 名称不一致, 比如我有个文件夹名字是mypackage,其中包含了a.go,b.go, c.go三个文件 : ~~~ mypackage | --a.go | --b.go | --c.go ~~~ 比如a.go中有 Saya(),b.go中有Sayb() 而几个文件共同的package name 确是testpackage 所以在 主函数中调用a.go 和b.go文件中的各自方法只要用,testpackage.Saya() ,testpackage.Sayb()即可 还有默认的init方法,在import进来的时候就去执行了,而且允许每个文件中都有init()这个方法,当然是每个都会执行。 导出包: 在 Go 中,包中成员以名称首字母大小写决定访问权限。首字母大写的名称是被导出的。 在导入包之后,你只能访问包所导出的名字,任何未导出的名字是不能被包外的代码访问的。 Foo 和 FOO 都是被导出的名称。名称 foo 是不会被导出的。 ~~~ • public: 首字母大写,可被包外访问。 • internal: 首字母小写,仅包内成员可以访问。 ~~~ 该规则适用于全局变量、全局常量、类型、结构字段、函数、方法等。 导入包 :使用包成员前,必须先用 import 关键字导入,但不能形成导入循环。 import "相对目录/包主文件名" 相对目录是指从` <workspace>/pkg/<os_arch> `开始的子目录,以标准库为例: ~~~ import "fmt" -> /usr/local/go/pkg/darwin_amd64/fmt.a import "os/exec" -> /usr/local/go/pkg/darwin_amd64/os/exec.a ~~~ 在导入时,可指定包成员访问方式。比如对包重命名,以避免同名冲突。 import 用法: ~~~ import "fmt" 最常用的一种形式(系统包) import "./test" 导入同一目录下test包中的内容(相对路径) import "shorturl/model 加载gopath/src/shorturl/model模块(绝对路径) import f "fmt" 导入fmt,并给他启别名f import . "fmt" 将fmt启用别名".",这样就可以直接使用其内容,而不用再添加fmt。 如fmt.Println可以直接写成Println import _ "fmt" 表示不使用该包,而是只是使用该包的init函数,并不显示的使用该包的其他内容。 注意:这种形式的import,当import时就执行了fmt包中的init函数,而不能够使用该包的其他函数。 ~~~ 未使用的导入包,会被编译器视为错误 (不包括 `"import _"`)。 ~~~ ./main.go:4: imported and not used: "fmt" ~~~ 自定义路径 :可通过 meta 设置为代码库设置自定义路径。 ~~~ server.go package main import ( "fmt" "net/http" ) func handler(w http.ResponseWriter, r *http.Request) { fmt.Fprint(w, `<meta name="go-import" content="test.com/qyuhen/test git https://github.com/qyuhen/test">`) } func main() { http.HandleFunc("/qyuhen/test", handler) http.ListenAndServe(":80", nil) } ~~~ 该示例使用自定义域名 test.com 重定向到 github。 ~~~ $ go get -v test.com/qyuhen/test Fetching https://test.com/qyuhen/test?go-get=1 https fetch failed. Fetching http://test.com/qyuhen/test?go-get=1 Parsing meta tags from http://test.com/qyuhen/test?go-get=1 (status code 200) get "test.com/qyuhen/test": found meta tag http://test.com/qyuhen/test?go-get=1 test.com/qyuhen/test (download) test.com/qyuhen/test ~~~ 如此,该库就有两个有效导入路径,可能会导致存储两个本地副本。为此,可以给库添加专门的 "import comment"。当 go get 下载完成后,会检查本地存储路径和该注释是否一致。 ~~~ github.com/qyuhen/test/abc.go package test // import "test.com/qyuhen/test" func Hello() { println("Hello, Custom import path!") } ~~~ 如继续用 github 路径,会导致 go build 失败。 ~~~ $ go get -v github.com/qyuhen/test github.com/qyuhen/test (download) package github.com/qyuhen/test imports github.com/qyuhen/test imports github.com/qyuhen/test: expects import "test.com/qyuhen/test" ~~~ 这就强制包用户使用唯一路径,也便于日后将包迁移到其他位置。 Golang初始化 初始化函数: ~~~ • 每个源文件都可以定义一个或多个初始化函数。 • 编译器不保证多个初始化函数执行次序。 • 初始化函数在单一线程被调 ,仅执行一次。 • 初始化函数在包所有全局变量初始化后执行。 • 在所有初始化函数结束后才执行 main.main()。 • 无法调用初始化函数。 ~~~ 因为无法保证初始化函数执行顺序,因此全局变量应该直接用 var 初始化。 ~~~ var now = time.Now() func init() { fmt.Printf("now: %v\n", now) } func init() { fmt.Printf("since: %v\n", time.Now().Sub(now)) } ~~~ 可在初始化函数中使用 goroutine,可等待其结束。 ~~~ var now = time.Now() func main() { fmt.Println("main:", int(time.Now().Sub(now).Seconds())) } func init() { fmt.Println("init:", int(time.Now().Sub(now).Seconds())) w := make(chan bool) go func() { time.Sleep(time.Second * 3) w <- true }() <-w } ~~~ 输出: ~~~ init: 0 main: 3 ~~~ 不应该滥用初始化函数,仅适合完成当前文件中的相关环境设置。