快速开始

首先确保自己已经安装了 GO，版本在 1.16 之上，同时设置了 GOPATH 环境变量，并且将 GOPATH/bin 加入到了环境变量。

我们建议你直接使用最新的稳定版本，因为我们会尽量保持使用最新版本的 Go 版本。

如果你还没安装环境，请参考：

Windows 安装

Linux 安装

Mac 安装

请注意，在Beego V2 之后，我们要求使用go mod特性，请务必确保开启了go mod特性，即设置了GO111MODULE=on。

更多信息请参考Go module

同时，如果你是在中国大陆境内，我们建议你同时设置GORPOXY。在自己的环境变量里面设置：

  1. GOPROXY=https://goproxy.cn

接下来，我们来尝试启动一个hello world的例子。在这个例子里面，我们将使用Bee工具来创建hello world项目。

更多信息参考Bee

快速开始

如果你已经安装好了开发环境，那么你可以考虑使用我们的快速安装脚本。

Mac or Linux

在控制台直接执行以下语句：

  1. bash <(curl -s https://raw.githubusercontent.com/beego/beego-doc/main/scripts/quickstart.sh)

如果没有安装curl，那么可以使用wget，执行：

  1. bash <(wget -qO- https://raw.githubusercontent.com/beego/beego-doc/main/scripts/quickstart.sh)

如果你无法使用这两个命令，那么可以尝试直接下载这两个文件，而后执行。

Windows

使用curl：

  1. bash <(curl -s https://raw.githubusercontent.com/beego/beego-doc/main/scripts/quickstart.bat)

如果你没有安装curl命令，可以使用wget命令：

  1. bash <(wget -qO- https://raw.githubusercontent.com/beego/beego-doc/main/scripts/quickstart.bat)

如果你无法通过命令下载脚本，可以尝试自己下载脚本而后执行。

手动安装

在这一章节，我们会使用到go get命令，如果你还不熟悉它，我们建议你可以先阅读Go get

千万记住，如果你遇到了网络问题，或者超时问题，请务必确保自己设定了GOPROXY代理。

安装 Bee

我们来看一下手动如何安装Bee。在命令行里面执行：

  1. go get -u github.com/beego/bee/v2@master

而后运行

  1. bee version

你将看到类似输出：

  1. | ___ \
  2. | |_/ /  ___   ___
  3. | ___ \ / _ \ / _ \
  4. | |_/ /|  __/|  __/
  5. \____/  \___| \___| v2.0.x
  7. ├── Beego     : Beego is not installed. Please do consider installing it first: https://github.com/beego/beego/v2. If you are using go mod, and you don't install the beego under $GOPATH/src/github.com/beego, just ignore this.
  8. ├── GoVersion : go1.16
  9. ├── GOOS      : linux
  10. ├── GOARCH    : amd64
  11. ├── NumCPU    : 12
  12. ├── GOPATH    : /home/xxx/go
  13. ├── GOROOT    : /home/aaa/bbb/go
  14. ├── Compiler  : gc
  15. └── Published : 2020-12-16

创建项目

执行：

  1. bee new hello

这会在当前目录下创建一个名叫hello的文件夹。

而后进入文件夹：

  1. cd hello

而后我们执行go mod tidy命令，来生成go.sum文件。

  1. go mod tidy

而后，我们尝试启动：

  1. bee run

如果没有错误的话，你会看到类似的输出：

  1. 2021/03/31 23:29:19 SUCCESS  ▶ 0004 Built Successfully!
  2. 2021/03/31 23:29:19 INFO     ▶ 0005 Restarting 'hello'...
  3. 2021/03/31 23:29:19 SUCCESS  ▶ 0006 './hello' is running...
  4. 2021/03/31 23:29:22.016 [I] [parser.go:413]  generate router from comments
  6. 2021/03/31 23:29:22.016 [I] [server.go:241]  http server Running on http://:8080

如果你启动不成功，请先确认自己的 8080 端口是否被占用了。