基礎(chǔ)配置篇：建立項(xiàng)目，為我的博客項(xiàng)目制定目錄層次結(jié)構(gòu)和項(xiàng)目初始化

時(shí)間：2023-06-11 23:18:02 | 來源：網(wǎng)站運(yùn)營

時(shí)間：2023-06-11 23:18:02 來源：網(wǎng)站運(yùn)營

基礎(chǔ)配置篇：建立項(xiàng)目，為我的博客項(xiàng)目制定目錄層次結(jié)構(gòu)和項(xiàng)目初始化：前期準(zhǔn)備、構(gòu)思已經(jīng)相對比較完善了，我們在構(gòu)思章節(jié)中，已經(jīng)明確了我們的需求，知道我們的博客他需要有些什么功能，博客的數(shù)據(jù)庫設(shè)計(jì)、博客的界面設(shè)計(jì)等信息。也大致了解到了golang的安裝配置、基本語法等。

這一節(jié)內(nèi)容中，我們將開始進(jìn)行我們最重要的一步，開始實(shí)戰(zhàn)學(xué)習(xí)golang了。

目錄結(jié)構(gòu)

一個清晰明確的目錄結(jié)構(gòu)，可以讓項(xiàng)目更清晰，更好維護(hù)和擴(kuò)展。目錄結(jié)構(gòu)的組織，也是可以靈活變動的。它本身沒有一個嚴(yán)格規(guī)定的格式。我們只需要做到合適、合理、清晰就可以。下面是我對博客程序設(shè)計(jì)的目錄結(jié)構(gòu)的設(shè)計(jì)。目錄都采用一級目錄形式放置，目錄名稱采用對應(yīng)功能的英文來命名。

├── main 入口文件目錄├── cache 緩存目錄├── config 配置文件處理目錄├── controller 控制器目錄├── library 一些功能函數(shù)存放目錄├── middleware 中間件存放目錄├── model 數(shù)據(jù)庫模型文件存放的目錄├── provider 控制器和數(shù)據(jù)庫交互讀寫的中間層處理函數(shù)目錄├── public 對外公開的目錄├── request 前端頁面提交的數(shù)據(jù)模型定義目錄├── route 路由器存放目錄└── template 頁面模板文件目錄創(chuàng)建完成后的目錄結(jié)構(gòu)大概是這樣：

• 根目錄就是用來放置上面這些文件夾的目錄，包括項(xiàng)目配置文件等。
• main目錄是博客網(wǎng)站項(xiàng)目入口目錄，將main.go放置在這個位置，編譯的時(shí)候，也是通過這個目錄編譯。
• cache目錄是博客網(wǎng)站項(xiàng)目的緩存目錄，生成的文件緩存，都會放置在這里
• config目錄是博客網(wǎng)站項(xiàng)目的配置文件處理目錄，里面放配置的初始化和讀寫等函數(shù)
• controller目錄是博客網(wǎng)站項(xiàng)目的控制器目錄，所有的控制器都放置在這里
• library目錄是博客網(wǎng)站項(xiàng)目的一些功能函數(shù)存放目錄
• middleware目錄是博客網(wǎng)站項(xiàng)目的中間件存放目錄
• model博客網(wǎng)站項(xiàng)目的數(shù)據(jù)庫模型文件存放的目錄
• provider目錄是博客網(wǎng)站項(xiàng)目控制器和數(shù)據(jù)庫交互讀寫的中間層處理函數(shù)存放目錄
• public目錄是博客網(wǎng)站項(xiàng)目對外公開的目錄，放置一些靜態(tài)文件可供直接瀏覽，如js、css、images等
• request目錄是博客網(wǎng)站項(xiàng)目前端頁面提交的數(shù)據(jù)模型定義目錄，規(guī)定了前端提交的數(shù)據(jù)字段和數(shù)據(jù)格式
• route目錄是博客網(wǎng)站項(xiàng)目的路由器存放目錄，定義了博客有哪些路徑是暴露出來提供訪問的
• template目錄是博客網(wǎng)站項(xiàng)目的頁面模板文件目錄，每一個控制器對應(yīng)一個文件夾和文件

項(xiàng)目初始化

上面我們已經(jīng)創(chuàng)建好目錄了，接著，我們就開始使用golang的包管理命令來初始化我們的項(xiàng)目?，F(xiàn)在新版的golang，使用go mod 命令來初始化項(xiàng)目和管理依賴。

避坑說明：如果你的安裝的golang版本低于1.13，那么請先升級到1.13，以方便后續(xù)的操作。更高版本有更多的特性支持。如果你將項(xiàng)目創(chuàng)建在了pkg目錄，那么使用go mod命令管理默認(rèn)是會出錯的，我們需要執(zhí)行一條命令解決這個沖突，讓他允許這么操作

go env -w GO111MODULE=on還有眾所周知的原因，我們并不能直接訪問到golang官網(wǎng)，導(dǎo)致一些官方包無法正常下載，我們還需要再執(zhí)行一個命令，來設(shè)置代理地址。

go env -w GOPROXY=https://goproxy.cn,https://goproxy.io,direct有了這2步的前提操作，下面就可以放心大膽的使用了。

初始化項(xiàng)目

go mod init iriswebgo mod init 項(xiàng)目名稱 就可以初始化一個指定項(xiàng)目名稱的golang項(xiàng)目。比如這里我們這里將項(xiàng)目命名為irisweb。

載模塊包到本地cache

目前所有模塊版本數(shù)據(jù)均緩存在 $GOPATH/pkg/mod和 ?$GOPATH/pkg/sum 下。不過一般上這個命令可以不用，直接使用go mod tidy 也是可以的。

go mod download

刪除錯誤或者不使用的模塊包，更新下載未下載的模塊包

這個命令可以將多余的包刪除掉，并且會自動下載新添加的包

go mod tidy

生成vendor目錄

包下載下來了，還需要生成到vendor目錄，才能正確的引入和編譯，否則是會報(bào)錯的。

go mod vendor

其他包管理命令

# 編輯go.mod文件 選項(xiàng)有-json、-require和-exclude，可以使用幫助go help mod editgo mod edit# 以文本模式打印模塊需求圖go mod graph# 驗(yàn)證依賴是否正確go mod verify# 查找依賴go mod why# 更新到最新版本go get gorm.io/gorm@version# 清理moudle 緩存go clean -modcache# 替代只能翻墻下載的庫go mod edit -replace=golang.org/x/sys@v0.0.0=github.com/golang/sys@latest# 查看可下載版本go list -m -versions gorm.io/gorm完整的項(xiàng)目示例代碼托管在GitHub上，需要查看完整的項(xiàng)目代碼可以到github.com/fesiong/goblog 上查看，也可以直接fork一份來在上面做修改。