From cea583ddf9ec82be6f57234ed7e36f0246c6ddb1 Mon Sep 17 00:00:00 2001 From: Unknown Date: Sat, 20 Apr 2013 16:46:37 -0400 Subject: [PATCH] 03.5.md --- README.md | 2 +- eBook/03.5.md | 38 ++++++++++++++++++++++++-------------- eBook/03.6.md | 21 +++++++++++++++++++++ eBook/directory.md | 1 + 4 files changed, 47 insertions(+), 15 deletions(-) create mode 100644 eBook/03.6.md diff --git a/README.md b/README.md index 70a5867..245bd6f 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ 该翻译版本已获得原作者（Ivo Balbaert）本人授权，并表示支持开源事业的发展！ ##翻译进度 -3.4 [构建并运行 Go 程序](eBook/03.4.md) +3.5 [格式化代码](eBook/03.5.md) ##支持本书 如果你喜欢本书《Go入门指南》，你可以参与到本书的翻译或纠正工作中来，具体请联系译者，一同完善本书并帮助壮大 Go 语言在国内的学习群体，给大家提供更好的学习资源。 diff --git a/eBook/03.5.md b/eBook/03.5.md index 97142a8..9252311 100644 --- a/eBook/03.5.md +++ b/eBook/03.5.md @@ -1,19 +1,29 @@ -##啊哦，亲，你看得也太快了。。。还没翻译完呢 0 0 -要不等到 ***2013 年 4 月 20 日*** 再来看看吧~~ - -这里还有一些其它的学习资源噢~ - - - [《Go编程基础》](https://github.com/Unknwon/go-fundamental-programming)：已更新至 [第八课](https://github.com/Unknwon/go-fundamental-programming/blob/master/lecture8/lecture8.md) - - [《Go Web编程》](https://github.com/astaxie/build-web-application-with-golang) - -神马？你说你不想学习？那好吧，去逛逛论坛看看行情也行~ - -- [Golang中文社区](http://bbs.mygolang.com/forum.php) -- [Go语言学习园地](http://studygolang.com/) -- [Golang中国](http://golang.tc) - #3.5 格式化代码 +Go 开发团队不想要 Go 语言像许多其它语言那样总是在为代码风格而引发无休止的争论，浪费大量宝贵的开发时间，因此他们制作了一个工具：`go fmt`（`gofmt`）。这个工具可以将你的源代码格式化成符合官方统一标准的风格，属于语法风格层面上的小型重构。遵循统一的代码风格是 Go 开发中无可撼动的铁律，因此你必须在编译或提交版本管理系统之前使用 `gofmt` 来格式化你的代码。 +尽管这种做法也存在一些争论，但使用 `gofmt` 后你不再需要自成一套代码风格而是和所有人使用相同的规则。这不仅增强了代码的可读性，而且在接手外部 Go 项目时，可以更快地了解其代码的含义。此外，大多数开发工具也都内置了这一功能。 + +Go 对于代码的缩进层级方面使用 tab 还是空格并没有强制规定，一个 tab 可以代表 4 个或 8 个空格。在实际开发中，1 个 tab 应该代表 4 个空格，而在本身的例子当中，每个 tab 代表 8 个空格。至于开发工具方面，一般都是直接使用 tab 而不替换成空格。 + +在命令行输入 `gofmt –w program.go` 会格式化该源文件的代码然后将格式化后的代码覆盖原始内容（如果不加参数 `-w` 则只会打印格式化后的结果而不重写文件）；`gofmt -w *.go` 会格式化并重写所有 Go 源文件；`gofmt map1` 会格式化并重写 map1 目录及其子目录下的所有 Go 源文件。 + +`gofmt` 也可以通过在参数 `-r` 后面加入用双引号括起来的替换规则实现代码的简单重构，规则的格式：`<原始内容> -> <替换内容>`。 + +实例： + + gofmt -r “(a) -> a” –w *.go + +上面的代码会将源文件中没有意义的括号去掉。 + + gofmt -r “a[n:len(a)] -> a[n:]” –w *.go + +上面的代码会将源文件中多余的 `len(a)` 去掉。（ ***译者注：了解 slice 之后就明白这为什么是多余的了*** ） + + gofmt –r ‘A.Func1(a,b) -> A.Func2(b,a)’ –w *.go + +上面的代码会将源文件中符合条件的函数的参数调换位置。 + +如果想要了解有关 `gofmt` 的更多信息，请访问该页面：[http://golang.org/cmd/gofmt/](http://golang.org/cmd/gofmt/) ##链接 - [目录](directory.md) diff --git a/eBook/03.6.md b/eBook/03.6.md new file mode 100644 index 0000000..3a68789 --- /dev/null +++ b/eBook/03.6.md @@ -0,0 +1,21 @@ +##啊哦，亲，你看得也太快了。。。还没翻译完呢 0 0 +要不等到 ***2013 年 4 月 22 日*** 再来看看吧~~ + +这里还有一些其它的学习资源噢~ + + - [《Go编程基础》](https://github.com/Unknwon/go-fundamental-programming)：已更新至 [第八课](https://github.com/Unknwon/go-fundamental-programming/blob/master/lecture8/lecture8.md) + - [《Go Web编程》](https://github.com/astaxie/build-web-application-with-golang) + +神马？你说你不想学习？那好吧，去逛逛论坛看看行情也行~ + +- [Golang中文社区](http://bbs.mygolang.com/forum.php) +- [Go语言学习园地](http://studygolang.com/) +- [Golang中国](http://golang.tc) + +#3.6 生成代码文档 + + +##链接 +- [目录](directory.md) +- 上一节：[格式化代码](03.5.md) +- 下一节：[其它工具](03.7.md) \ No newline at end of file diff --git a/eBook/directory.md b/eBook/directory.md index 663bcc3..cce9281 100644 --- a/eBook/directory.md +++ b/eBook/directory.md @@ -21,6 +21,7 @@ - 3.4 [构建并运行 Go 程序](03.4.md) - 3.5 [格式化代码](03.5.md) - 3.6 [生成代码文档](03.6.md) + - 3.7 [其它工具](03.7.md) ##第二部分：语言的核心结构与技术 - 第4章：基本结构和基本数据类型