Golang极简入门教程(四):编写第一个项目_Golang

workspace

Golang 的代码必须放置在一个 workspace 中。一个 workspace 是一个目录,此目录中包含几个子目录:

1.src 目录。包含源文件,源文件被组织为包(一个目录一个包)
2.pkg 目录。包含包对象(package objects)
3.bin 目录。包含可执行的命令

包源文件(package source)被编译为包对象(package object),命令源文件(command source)被编译为可执行命令(command executable)。使用 go 命令进行构建生成的包对象位于 pkg 目录中,生成的可执行命令位于 bin 目录中。开发 Golang 需要设置一个环境变量 GOPATH,此环境变量用于指定 workspace 的路径,另外,也可以把 workspace 的 bin 目录加入到 PATH 环境变量中去。

包路径

包位于 src 目录下,只要不发生冲突(例如和标准库冲突),我们可以使用任意的包路径。假如我们在 GitHub 有一个账号 name5566,并且存在一个项目 hello,那么我们可以在 src 目录下构建这样的目录结构:

复制代码 代码如下:

github.com/name5566/hello

第一个可执行命令

现在来编写第一个 Golang 程序 hello。假定已经配置好了 GOPATH,并且包路径使用 github.com/name5566/hello,在此目录下创建文件 hello.go:

复制代码 代码如下:

package main
 
import "fmt"
 
func main() {
    fmt.Printf("Hello, world.\n")
}

执行命令(可在任意处执行):

复制代码 代码如下:

go install github.com/name5566/hello

这个命令可以编译 hello 命令,生成一个可执行命令 hello 并放置于 bin 目录下。如果 go 命令没有任何输出表示执行成功。

第一个包对象

现在开始创建一个包对象(也就是库文件),首先建立包路径 github.com/name5566/newmath,在此目录下创建文件 sqrt.go:

复制代码 代码如下:

package newmath
 
func Sqrt(x float64) float64 {
    z := 1.0
    for i := 0; i < 1000; i++ {
        z -= (z*z - x) / (2 * z)
    }
    return z
}

我们可以测试编译此包:

复制代码 代码如下:

go build github.com/name5566/newmath

此命令不会有任何输出文件,如果需要在 pkg 目录下生成包对象,使用 go install。

现在来修改一下 hello.go:

复制代码 代码如下:

package main
 
import (
    "fmt"
    "github.com/name5566/newmath"
)
 
func main() {
    fmt.Printf("Hello, world. Sqrt(2) = %v\n", newmath.Sqrt(2))
}

编译安装 hello:

复制代码 代码如下:

go install github.com/name5566/hello

go 命令能够自己分析依赖关系,这里的 newmath 包会被自动安装到 pkg 目录下。

另外需要注意的是,Golang 使用静态链接(运行 Go 程序无需包对象)。

测试

Golang 带有轻量级测试框架,主要包括:

1.go test 命令
2.testing 包

创建文件 _test.go 来编写测试,例如为 sqrt.go 创建的测试文件为 sqrt_test.go:

复制代码 代码如下:

package newmath
 
import "testing"
 
func TestSqrt(t *testing.T) {
    const in, out = 4, 2
    if x := Sqrt(in); x != out {
        t.Errorf("Sqrt(%v) = %v, want %v", in, x, out)
    }
}

执行测试使用 go test:

复制代码 代码如下:

go test github.com/name5566/newmath

测试文件中包含的所有测试函数 func TestXxx(t *testing.T) 都会被执行。测试函数可以通过 Error、Fail 等相关方法告知出现错误。

另外,在测试文件中还可以编写范例代码,例如:

复制代码 代码如下:

func ExampleHello() {
    fmt.Println("hello")
    // Output: hello
}

这里 Example 函数结尾可以跟上一个以 “Output:” 字符串开始的注释(被叫做输出注释),在测试运行时会将 Example 函数输出注释中字符串和函数标准输出进行比对。需要注意的是,如果没有输出注释,Example 函数是不会被运行的(但是会被编译)。

Example 函数命名有这样的习惯:

复制代码 代码如下:

func Example() { ... }
func ExampleF() { ... }
func ExampleT() { ... }
func ExampleT_M() { ... }

这里的 F 为函数名,T 为类型名,T_M 为类型 T 上的方法 M。

获取远程仓库的包

使用 go get 能够自动获取远程仓库的包,例如:

复制代码 代码如下:

go get code.google.com/p/go.example/hello

时间: 2024-10-22 16:13:02

Golang极简入门教程(四):编写第一个项目_Golang的相关文章

Golang极简入门教程(三):并发支持_Golang

Golang 运行时(runtime)管理了一种轻量级线程,被叫做 goroutine.创建数十万级的 goroutine 是没有问题的.范例: 复制代码 代码如下: package main   import (     "fmt"     "time" )   func say(s string) {     for i := 0; i < 5; i++ {         time.Sleep(100 * time.Millisecond)       

Golang极简入门教程(一):基本概念_Golang

安装 Golang 在 http://golang.org/dl/ 可以下载到 Golang.安装文档:http://golang.org/doc/install. Hello Go 我们先创建一个文件 hello.go: 复制代码 代码如下: package main   import "fmt"   func main() {     fmt.Printf("hello Golang\n"); } 执行此程序: 复制代码 代码如下: go run hello.g

Golang极简入门教程(二):方法和接口_Golang

方法 在 Golang 中没有类,不过我们可以为结构体定义方法.我们看一个例子: 复制代码 代码如下: package main   import (     "fmt"     "math" )   type Vertex struct {     X, Y float64 }   // 结构体 Vertex 的方法 // 这里的方法接收者(method receiver)v 的类型为 *Vertex func (v *Vertex) Abs() float64

JavaScript极简入门教程(一):基础篇_javascript技巧

阅读本文需要有其他语言的编程经验. 开始学习之前 大多数的编程语言都存在好的部分和差的部分.本文只讲述 JavaScript 中好的部分,这是因为: 1.仅仅学习好的部分能够缩短学习时间 2.编写的代码更加健壮 3.编写的代码更加易读 4.编写的代码更加易于维护 弱类型和强类型 通常来说,越早的修复错误,为之付出的代价就越小.强类型语言的编译器可以在编译时检查某些错误.而 JavaScript 是一门弱类型语言,其解释器无法检查类型错误,但实践表明: 1.强类型能够避免的错误并不是那些关键性错误

JavaScript极简入门教程(二):对象和函数_javascript技巧

阅读本文需要有其他语言的编程经验. JavaScript 中的简单类型包括: 1.数字 2.字符串 3.布尔(true 和 false) 4.null 5.undefined 此外的其他类型均是对象(我们不要被 typeof 操作符的返回值所迷惑),例如: 1.函数 2.数组 3.正则表达式 4.对象(对象自然也是对象) 对象基础 在 JavaScript 中,对象是属性的集合(对象为关联数组),每个属性包括: 1.属性名,必须为字符串 2.属性值,可以为除了 undefined 之外的任何值

Nodejs极简入门教程(三):进程_node.js

Node 虽然自身存在多个线程,但是运行在 v8 上的 JavaScript 是单线程的.Node 的 child_process 模块用于创建子进程,我们可以通过子进程充分利用 CPU.范例: 复制代码 代码如下: var fork = require('child_process').fork; // 获取当前机器的 CPU 数量 var cpus = require('os').cpus(); for (var i = 0; i < cpus.length; i++) {     // 生

Nodejs极简入门教程(二):定时器_node.js

setTimeout 和 clearTimeout 复制代码 代码如下: var obj = setTimeout(cb, ms); setTimeout 用于设置一个回调函数 cb,其在最少 ms 毫秒后被执行(并非在 ms 毫秒后马上执行).setTimeout 返回值可以作为 clearTimeout 的参数,clearTimeout 用于停止定时器,这样回调函数就不会被执行了. setInterval 和 clearInterval 复制代码 代码如下: var obj = setInt

Nodejs极简入门教程(一):模块机制_node.js

JavaScript 规范(ECMAScript)没有定义一套完善的能适用于大多数程序的标准库.CommonJS 提供了一套 JavaScript 标准库规范.Node 实现了 CommonJS 规范. 模块基础 在 Node 中,模块和文件是一一对应的.我们定义一个模块: 复制代码 代码如下: // circle.js var PI = Math.PI;   // 导出函数 area exports.area = function(r) {     return PI * r * r; }  

JavaScript极简入门教程(三):数组_javascript技巧

阅读本文需要有其他语言的编程经验. 在 JavaScript 中数组是对象(而非线性分配的内存). 通过数组 literal 来创建数组: 复制代码 代码如下: var empty = []; var numbers = [     'zero', 'one', 'two', 'three', 'four',     'five', 'six', 'seven', 'eight', 'nine' ]; empty[1] // undefined numbers[1] // 'one' empty