Gorun 使用与技术文档

1. 安装指南

Gorun 可以通过两种方式安装：

Ubuntu 包安装

$ sudo add-apt-repository ppa:gophers/go
$ sudo apt-get update
$ sudo apt-get install golang

源代码安装

可以使用 go get 命令从 Launchpad 或 Github 安装 gorun：

从 Launchpad 安装（需要 Bazaar）：

$ go get launchpad.net/gorun

从 Github 安装（需要 Git）：

$ go get github.com/erning/gorun

2. 项目的使用说明

Gorun 允许在 Go 程序的源代码中放置一个 "bang line" 来直接运行它，或者显式地运行这样的源代码文件。以下是一个使用示例：

将以下内容复制到名为 "hello.go" 的文件中：

#!/usr/bin/env gorun

package main

func main() {
    println("Hello world!")
}

或者，如果你希望文件与其他工具兼容，可以使用：

/// 2>/dev/null ; gorun "$0" "$@" ; exit $?

package main

func main() {
    println("Hello world!")
}

然后，运行以下命令来执行文件：

$ chmod +x hello.go
$ ./hello.go

执行后，将输出：

Hello world!

3. 项目 API 使用文档

Gorun 工具不提供传统意义上的 API，但是它的使用方式非常简单。你可以通过在 Go 源文件的开头添加 #!/usr/bin/env gorun 来直接运行该文件。

4. 项目安装方式

项目的安装方式已在“安装指南”部分详细说明，可以通过 Ubuntu 包安装或源代码安装。

注意事项

• 编译后的文件存放在 $TMPDIR（或 /tmp）下，确保实际脚本位置不被修改（可能是只读的）。
• 避免同一文件并行执行时的冲突。
• 自动清理长时间未使用的旧编译文件，且不会发生冲突。
• 替换进程而不是使用子进程。
• 正确传递参数给编译后的应用程序。
• 处理 GOROOT、GOROOT_FINAL 以及工具链的位置。
• 支持嵌入式 go.mod、go.sum 和编译时使用的环境变量，确保可重复构建。

Gorun 的构建速度很快，不会显著影响开发效率。