Emacs给Go一个更好的Playground

题目中虽提到了 Emacs ,但其实本文主要讲述是一个Emacs的神级插件---org-mode的故事。 org-mode 不了解的,请自行Google!
在未使用 org-mode 前,学习和实验Go的特性(例如 context )的步骤如下:

  • 打开终端
  • 跳转到学习示例目录下
  • 创建子目录,例如 context , 然后跳入子目录, 创建 main.go 文件
  • 编写简单的示例代码
  • 编译和运行代码示例,若出错调试,返回上个步骤

上面的过程有些可精简,例如在IDE中,目录跳转可在对话框中完成,代码的编写,编译和运行都可在IDE中完成。 在IDE中流程如下:

  • 在学习示例目录下,创建一个新的示例工程
  • 编写简单的示例代码, 编译和运行

在IDE中,整个流程精简了很多。 作为语言使用者,我们可能需要把实验过的示例代码留存,以便能应用在日后的开发中。 上面的两个流程,都会根据实验的包或者语言特性,创建相应的子目录,经过这样的处理,代码示例都聚合到了一起,方便了翻阅和修改。 示例代码的执行结果,大多是直接输出到终端的,你要验证原有示例代码的执行结果,你必须要重新执行代码,因为执行结果并没有留存。 若是这个示例代码,是很久之前的,可能是一年以前的, 这个时候你看到代码的时候,可能会时一脸懵逼。 这个时候你会想,为什么当时没有多留些信息,让我知道,为什么做这个示例,以及这段代码完成了什么功能。

Org-mode 简单配置后, 可完美的解决以上问题,代码留存,执行结果留存,文学编程(在编码过程中书写文档)。

上图展示了一个子问题的各个部分,问题描述,解决方案,代码,以及代码的执行结果。 子问题对应 Org-mode 中的子目录,然后所有问题都可聚合在一个 Org-mode 文档中。 现在流程可简化为:

  • 跳转到 Org-mode 文档中
  • 创建子目录,书写解决方案,编码实现

借助 Org-mode 强大的特性,可很容易的复用代码以及查询。

对于 Org-mode 不熟悉的,可先浏览Org-mode的主页Org-mode 通过 Babel 执行代码,对此不熟悉的读者, 可阅读我之前翻译的文档

ob-go

Babel 可执行多种语言的代码, 但官方的收录的语言支持中,没有Go。 但Go是如此的炙手可热,没有官方支持,肯定也会有先行者实现支持。 感谢 popeob-C 实现了ob-go , 实现了 Babel 对于Go的支持。

简介

ob-go 使 Org-babel 可执行Go代码。 与解释语言可直接执行不同,Go需要先编译为可执行文件,然后运行。 Go代码通过 go run 命令编译和运行。 若代码中没有 main 函数,默认情况下,代码会被包裹在简单的 main 函数中。 若 :package 选项没设置并且代码中没有声明 package , 则 main package 被声明。 示例如下,代码被执行,执行结果被回写到 buffer 中。

#+BEGIN_SRC go :imports "fmt"
  fmt.Println("Hello, org-mode")
#+END_SRC

#+RESULTS:
: Hello, org-mode

使用快捷键 C-c C-v v 可查看被扩展后的代码。

Go特定的头参数(Header Arguments)

除了 Babel 的常规头参数之外,下面是一些Go语言特定的头文件。

  • :args: 传递命令行参数到代码编译后的可执行文件,传递超过多参数,需要使用 list
  • :flags: 传递给 go run 或者 go build 的flags(未使用成功)。
  • :main: 若没设置 no , 代码将会被包裹在 main 函数中。默认 yes
  • :imports: 为代码提供 imports 的快捷支持。 当处理 main 函数时,应该使用这个选项。 要 import 多个包,请使用 list
  • :package: 设置当前代码块 tangle 时的包名。 需要: :main no 。 若没设置,同时代码中没有包名声明, main 包将被声明。
  • :var: ob-go 支持 Babel 的变量,不过目前还不完备。

配置

这里假设Go的开发环境已经配置完毕,同时你的机器上的 EmacsOrg-mode 都是最近的版本,对于 Babel 都是完整支持的。 由于 ob-go 没有并入 Org-mode 所以需要单独配置。 步骤如下:

  • M-x find-library ob-C , 找到的目录 org-plus-contrib

  • 新建 ob-go.el , 然后把 github中代码 复制到新建的文件中

  • 配置 org-babel-load-languages, 如下:

    (org-babel-do-load-languages
     'org-babel-load-languages
     '((python . t)
       (C . t)
       (go . t)
       (emacs-lisp . t)
       (shell . t)))
    

编码流程

最近在 LeetCode 上做编程训练,这里就以解决上面的问题的流程来做说明。

  • 在LeetCode页面上,仔细阅读和理解问题,这里以 Merge Two Binary Trees 为例

  • 跳转到 leetcode.org , 创建 merge two binary trees 子目录

  • 创建名为 merge-two-bt 的Go代码块

  • 通过快捷键 C-c ' 打开Go语言特定的编辑模式buffer中,然后编码。 在编码过程完成后, C-c ' 完成并关闭编辑buffer;或者对自己编辑不满意, C-c C-k 取消编辑并关闭编辑buffer。

  • 把定义好的代码块整合到一起,然后执行(完整代码)。

使用示例

导入多个包

#+BEGIN_SRC go :imports '("fmt" "time")
  fmt.Println("当前时间:", time.Now())
#+END_SRC

#+RESULTS:
: 当前时间: 2017-06-12 18:04:20.562355811 +0800 CST

命令行参数传递

#+BEGIN_SRC go :imports '("fmt" "os") :args '("bable" "golang")
  fmt.Println(os.Args[1], os.Args[2])
#+END_SRC

#+RESULTS:
: bable golang

多入参

#+NAME: sum
#+BEGIN_SRC go :imports "fmt" :var a=12 b=13
  fmt.Println(a+b)
#+END_SRC

#+RESULTS:
: 25

#+call: sum(a=22,b=23)

#+RESULTS:
: 45

代码组织

#+NAME: min
#+BEGIN_SRC  go
  func min(a, b int) int {
    if a > b {
      return b
    } else {
      return a
    }
  }
#+END_SRC

#+NAME: get-min
#+BEGIN_SRC go :var a=0 b=0 :imports "fmt" :noweb strip-export
  <<min>>

  func main() {
    fmt.Println(min(a,b))
  }
#+END_SRC

#+call: get-min(27, 23)

#+RESULTS:
: 23

总结

Org-mode于我来说,就是一个神器,打破了我对一个编辑器的认知,打破了我对一个信息收集器的认知。 Org-mode依托于强大的 Emacs, 借助于 Babel, 使文档和代码无缝的结合在了一起, 一会编码,一会记录, 一会调试,一会执行。 不失为,学习语言,尝试新工具的不二神器。 再来一段Go代码:

#+BEGIN_SRC go :imports "fmt"
  fmt.Println("Goodbye, Gopher!")
#+END_SRC
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容

  • 序言 概述 初始配置 代码块代码块在 Org-mode 中代码块在 Babel 中 源代码执行示例RubyShel...
    brantou阅读 3,526评论 0 7
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,585评论 18 139
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,724评论 6 342
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,400评论 25 707
  • 这是爸妈在我家住的最后一个晚上,明天他们就要回他们的家了,在两千公里外的长春,有一个七十多平米的老楼房,那曾...
    莫聽穿林阅读 1,069评论 7 5