I like using shebangs to run my Perl scripts directly:
#!/usr/bin/env perl
What's the shebang for Go programs?
//usr/bin/go run $0 $@ ; exit
example:
//usr/bin/go run $0 $@ ; exit
package main
import "fmt"
func main() {
fmt.Println("Hello World!")
}
go treat //
as a single line comment
and shell ignore extra /
Update: Go installation may be in a different location. The syntax below will take that into account, and works for Macs:
//$GOROOT/bin/go run $0 $@ ; exit
$0
or such?
#!
. (Knowing that go doesn't like it). This is non portable, but perhaps good enough for many people, so +1 for the answer.
///usr/bin/env go run $0 $@ ; exit
//usr/bin/env go run "$0" "$@"; exit "$?"
Commented
Nov 9, 2014 at 19:12
bash hello.go
, but not with just ./hello.go
. Does this work for somebody else? I'm on macOS, maybe this works differently on Linux?
Commented
Mar 21, 2021 at 10:59
I prefer this:
///usr/bin/true; exec /usr/bin/env go run "$0" "$@"
This has several advantages compared to the answer by هومن جاویدپور:
The ///usr/bin/true
accomplishes the feat of simultaneously being valid Go and shell syntax. In Go it is a comment. In shell, it is no-op command.
Uses exec
to replace the new shell process instead of launching a grandchild process. As a result, your Go program will be a direct child process. This is more efficient and it's also important for some advanced situations, such as debugging and monitoring.
Proper quoting of arguments. Spaces and special characters won't cause problems.
The leading ///
is more standards compliant than just //
. If you only use //
, you run the risk of bumping into implementation-defined behaviour. Here's a quote from http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap04.html:
If a pathname begins with two successive
/
characters, the first component following the leading/
characters may be interpreted in an implementation-defined manner, although more than two leading/
characters shall be treated as a single/
character.
I have tested this answer with bash, dash, zsh, and ksh.
Example:
///usr/bin/true; exec /usr/bin/env go run "$0" "$@"
package main
import "fmt"
func main() {
fmt.Println("你好!")
}
/bin/true
is not as portable (e.g. OSX and Zsh)
Commented
Dec 2, 2015 at 11:34
///bin/true; TMPDIR="$(cd "$(dirname "${0}")" && pwd)" exec /usr/bin/go run "$0" "$@"
for it to work when /tmp is mounted with the no exec flag
Commented
Jan 26, 2017 at 18:00
///usr/bin/true
is just a way to begin the line with '//' which is the Go comment syntax, while still being a valid shell command. The 'true' command effectively does nothing. The real action happens with 'exec'. The reason we can't just start off with 'exec' is because it is shell builtin, not a normal program.
There isn't one by default. There is a third-party tool called gorun that will allow you to do it, though. https://wiki.ubuntu.com/gorun
Unfortunately the compilers don't like the shebang line. You can't compile the same code you run with gorun.
Go programs are compiled to binaries; I don't think there is an option to run them directly from source.
This is similar to other compiled languages such as C++ or Java. Some languages (such as Haskell) offer both a fully compiled mode and a "script" mode which you can run directly from source with a shebang line.
In my case, there was no GOROOT env. So I did this.
//$(go env | grep -i goroot | awk -F= '{print $2}' | sed 's/\"//g')/bin/go run $0 $@ ; exit
So far, chaining sh and gorun has proven to be the most portable solution for me.
///bin/sh -c true && exec gorun "$0" "$@"
package main
import (
"fmt"
"log"
"os"
)
func main() {
fmt.Println("hello")
log.Printf("args: %v", os.Args)
// just to test exit code, would be 0x11
os.Exit(17)
}
OUTPUT:
00:~ $ chmod a+x test.go && ./test.go rawr
hello
2020/01/21 23:17:40 args: [./test.go rawr]
11:~ $
/// 2>/dev/null; gorun "$0" "$@" ; exit $?
Seems to me the best combination of the answers thus far. It uses gorun
so it caches the compilation step (which speeds up your scripts greatly), and works on macOS, too.
Install gorun
with:
go get github.com/erning/gorun
Reading all this messages this seems the most portable:
///bin/sh -c true && exec /usr/bin/env go run "$0" "$@"
if really you want an executable (callable not fro shells) and not wanting to require gorun a possible solution could be something like:
#!/bin/sh
UMASK=`umask`
umask 077
tail -n +8 "$0" > /tmp/main.tmp.$$.go
umask $UMASK
(sleep 1 && rm -f /tmp/main.tmp.$$.go) &
exec go run /tmp/main.tmp.$$.go "$@"
package main
import "fmt"
func main() {
fmt.Println("hi")
}
My preference is this:
///usr/bin/env go run "$0" "$@"; exit
You can see this in my personal hello_world.go file. If I ever change my mind, I'll update that file.
Doing it this way is a bit of a mix between the main two answers right now (here and here).
Explanation:
///usr/bin/env
is the same as /usr/bin/env
. And, in Go, a double slash //
is a comment. So, now the first line is both a valid Bash/shell command and a valid Bash comment./usr/bin/env go
is better than /usr/bin/go
because your go
executable may not be located at /usr/bin/go
. which go
for me shows mine is located at /usr/local/go/bin/go
, for example. The env
program helps find your proper location.hello_world.go
, then running it directly as ./hello_world.go
will call go run "$0" "$@"
, which calls go run
on this executable, passing in the path to it as $0
and all other arguments as $@
.exit
at the end ensures that bash exits the file at that point and avoids trying to run your Go code as shell code. It's like commenting out the whole Go (to your shell at least) after the first line.From hello_world.go:
///usr/bin/env go run "$0" "$@"; exit
package main
import "fmt"
import "os"
func main() {
fmt.Println("Go: Hello World.")
os.Exit(1)
}
Sample run commands, and output:
eRCaGuy_hello_world/go$ ./hello_world.go
Go: Hello World.
exit status 1
eRCaGuy_hello_world/go$ go build -o bin/ hello_world.go && bin/hello_world
Go: Hello World.
eRCaGuy_hello_world/go$ go run hello_world.go
Go: Hello World.
exit status 1
//
and exit
parts: Shebang starting with //
?
//
?