(资料图片)

本篇将开始讲讲开发库/框架的最开始阶段，也就是搭建一个项目

源码：weloe/token-go: a light login library (github.com)

项目结构，不是上一篇所说的代码架构，而是分包，明确的分包更有助于我们的开发。本框架分包如下

├─.github│  └─workflows GitHub工作流├─auth权限管理├─config配置├─constant常量├─ctxweb上下文│  └─go-http-context├─error├─examples使用示例├─log日志├─model模型├─persist持久层└─util 工具包

我们选择使用GitHub进行代码托管，同时也使用GitHub Actions进行代码自动化测试。运行测试代码以及使用lint检查代码规范。

token-go/go.yml at master · weloe/token-go · GitHub

name: Go-Build-Teston: [push, pull_request]jobs:  test:    runs-on: ubuntu-latest    strategy:      matrix:        go: [ "1.18", "1.19", "1.20" ]    steps:      - uses: actions/checkout@v2      - name: Set up Go        uses: actions/setup-go@v2        with:          go-version: ${{ matrix.go }}      - name: Run go test        run: go test -v ./...  benchmark:    runs-on: ubuntu-latest    strategy:      matrix:        go: [ "1.18" ]    steps:      - uses: actions/checkout@v2      - name: Set up Go        uses: actions/setup-go@v2        with:          go-version: ${{ matrix.go }}      - name: Run go test bench        run: go test -bench=.  lint:    runs-on: ubuntu-latest    steps:      - uses: actions/checkout@v2      - name: Set up Go        uses: actions/setup-go@v2        with:          go-version: "1.20"      - name: golangci-lint        uses: golangci/golangci-lint-action@v3        with:          version: v1.51

在进行代码开发的同时，我们也应该进行代码测试用例的编写，提高代码测试覆盖率，确保我们的代码的健壮性。

文档可以说是一个开源库/框架必不可少的东西，我们开始学习一个开源库/框架也往往是从文档开始。我们可以使用Docsify，Vuepress等来快速搭建一个文档网站。关于如何搭建文档可以看看这篇随笔