Beego框架项目笔记Ⅰ——环境配置

684 阅读3分钟

Beego是一个简单易用的企业级Go应用开发框架,遵循Apache License开源协议,可从github查看完整项目代码,beego 采用了 Go 原生的 http 包来处理请求,goroutine 的并发效率足以应付大流量的 Web 应用和 API 应用,支持RESTful设计和MVC模型。

安装golang

使用beego需要先安装golang,golang是谷歌推出的一种开源编程语言,号称简单易学(这点真的存疑),原生支持协程,可用于云服务、命令行和网络工程开发,官网位于go.dev/,如果无法正常访问,可以使用国内地址,目前golang最新版是1.17.3。

golang官网提供各种系统(linux/mac/windows...)下已编译好的安装包,可以下载后直接解压,

环境变量

golang安装完成后需要设置环境变量,golang相关的环境变量有:

GOROOT: golang的安装路径,此路径下有api、bin、lib、pkg。

GOPATH: 你的主要工作目录的路径,此路径可能开始是空的,但是后面运行项目时会有mod、pkg目录存放项目依赖包。

PATH: 在原有的基础上添加golang路径,windows中使用%GOROOT%/bin%GOPATH%/bin,linux下使用$GOROOT/bin$GOPATH/bin

linux系统中使用export命令设置环境变量,为了开机自动配置,需要将命令写入~/.bashrc文件,编辑完成后执行source ~/.bashrc使环境变量生效。

image.png

windows系统中右击我的电脑 -> 属性 -> 高级系统设置 -> 环境变量进行设置,设置完成后新打开的cmd命令行中配置都会生效。

环境变量.png

完成后可以在命令行执行go version查看。

image.png

最后由于国内大家都懂的网络原因,需要设置代理,否则拉去依赖模块时可能失败。

go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct

Beego和Bee

配置完代理之后就可以使用go get命令安装beego框架和bee工具了。

go get github.com/astaxie/beego
go install github.com/beego/bee@latest

image.png

安装完成后查看GOPATH路径可发现目录下已出现bin目录和pkg目录,此后即可在命令行执行bee命令查看帮助说明。

image.png

bee工具一个遵循Apache License开源协议的可用于创建、启动、调试beego框架项目的工具,执行bee new tempgo即可在当前路径下创建一个名为tempgo的beego应用。

image.png

IDE

IDE意即集成开发环境(Integrated Development Environment),用于提供程序开发环境的应用程序,一般包括代码编辑器、编译器、调试器和图形用户界面等工具。所谓“工欲善其事必先利其器”,IDE的存在就是做为“器”,主要目的即是提高软件攻城狮的开发效率。

目前市面已有多款IDE支持golang开发,如golandLiteIDE甚至eclipse等,其中goland是jetbrains旗下的收费软件;LiteIDE据说是由由国人开发,具备简单的中文文档;eclipse依赖插件,占用资源较大。

而我选择使用微软旗下免费的VS Code,VS Code可以通过插件扩展的方式支持多种编程语言,对于beego框架项目开发,需要在VS Code中安装Go扩展插件beegoSnippets扩展插件并对go扩展插件进行相应配置,主要内容如下:

"go.docsTool":"gogetdoc",
"go.goroot": "D:/tools_for_program/golang",
"go.gopath": "E:/workspace/golang",
"go.testFlags": ["-v", "-count=1"],
"go.coverOnSave": false,
"go.gocodeAutoBuild": false,
"go.autocompleteUnimportedPackages": true

使用VS Code打开刚刚创建的tempgo项目,依照IDE提示安装gopls包和go-outline包等依赖,然后需要配置项目的启动参数等设置,VS Code调试项目依赖项目下的launch.json文件,此文件需要手动创建。

环境变量.png

在创建好的launch.json文件中写入如下内容并保存:

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息,请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "beego run",
            "type": "go",
            "request": "launch",
            "mode": "auto",
            "program": "${workspaceFolder}/main.go"
        }
    ]
}

项目起步

以上所有配置完毕后,可以在VS Code中使用F5快捷键启动刚刚创建的beego应用,成功启动后使用浏览器打开http://127.0.0.1:8080可打开项目默认页面。

环境变量.png