在许多企业中，员工绩效评估是管理工作中的重要环节。通常，绩效数据会以 Excel 表格的形式存储，而公司希望能够通过程序自动化读取这些表格，并根据一定的规则进行打分或分析。今天，我们将一起学习如何使用 GoZero 框架实现读取员工绩效表格 Excel，并根据设定的规则进行打分的功能。
1. 为什么选择 GoZero？
GoZero 是一个高效、易用的 Go 语言微服务框架，特别适合构建高性能的后端应用。GoZero 提供了很多便捷的功能，包括代码生成、路由、数据库操作、API 接口等，非常适合开发人员快速实现业务需求。在本篇博客中，我们将使用 GoZero 来搭建基础的框架，并结合 Go 的 `excelize` 库来处理 Excel 文件。
2. 所需工具和库
2.1 GoZero 框架
首先，确保你已经安装了 GoZero 框架。你可以通过以下命令安装 GoZero：
```bash
go get github.com/tal-tech/go-zero
```
2.2 Excelize 库
处理 Excel 文件的核心库是 [Excelize](https://github.com/xuri/excelize)，它是一个高效且功能强大的 Go 库，能够轻松读取和修改 Excel 文件。安装方法如下：
```bash
go get github.com/xuri/excelize/v2
```
3. 设计思路
我们的目标是：
-
读取 Excel 文件中的绩效数据（例如员工姓名、各项指标、得分等）。
-
根据设定的规则，计算每个员工的综合评分。
-
返回最终的绩效评分报告。
假设 Excel 表格的结构如下：
| 员工姓名 | 项目1得分 | 项目2得分 | 项目3得分 | 总分 |
| -------- | --------- | --------- | --------- | ----- |
| 张三 | 80 | 90 | 85 | 255 |
| 李四 | 70 | 75 | 80 | 225 |
| 王五 | 85 | 88 | 90 | 263 |
业务规则：
-
每个员工的绩效得分是由各个项目的得分累加得到的。
-
我们可以设置一个阈值，若总分低于该阈值，则给予"差评"，否则给予"良好"或"优秀"。
4. 实现步骤
4.1 初始化 GoZero 项目
首先，使用 GoZero 创建一个新的项目。在命令行中输入：
```bash
goctl init
```
然后按照提示创建你的 GoZero 项目，接着进入到项目文件夹中：
```bash
cd my-gozero-project
```
4.2 创建 Excel 读取和评分功能
我们将主要实现两个部分：
-
读取 Excel 文件。
-
根据项目得分进行计算，并生成评分结果。
4.3 编写代码
- **创建 Excel 读取功能**
首先，创建一个 `excel` 包，专门处理 Excel 文件的读取与处理。```go
// excel/excel.go
package excel
import (
"fmt"
"github.com/xuri/excelize/v2"
)
// 员工绩效数据结构
type EmployeeScore struct {
Name string
Scores []float64
Total float64
Grade string
}
// 读取 Excel 文件并返回员工绩效信息
func ReadExcel(filePath string) ([]EmployeeScore, error) {
// 打开 Excel 文件
f, err := excelize.OpenFile(filePath)
if err != nil {
return nil, fmt.Errorf("无法打开 Excel 文件: %v", err)
}
// 获取工作表名称
sheetName := f.GetSheetName(0) // 假设数据在第一个工作表
if sheetName == "" {
return nil, fmt.Errorf("无法获取工作表名称")
}
// 获取表格数据
rows, err := f.GetRows(sheetName)
if err != nil {
return nil, fmt.Errorf("读取 Excel 内容失败: %v", err)
}
var employeeScores []EmployeeScore
// 从第二行开始读取数据（假设第一行是表头）
for _, row := range rows[1:] {
// 假设员工姓名在第一列，得分在后面的列
name := row[0]
if name == "" {
continue
}
var scores []float64
var total float64
for i := 1; i < len(row)-1; i++ {
score, err := parseScore(row[i])
if err != nil {
continue
}
scores = append(scores, score)
total += score
}
// 计算绩效等级
grade := calculateGrade(total)
// 将结果添加到切片
employeeScores = append(employeeScores, EmployeeScore{
Name: name,
Scores: scores,
Total: total,
Grade: grade,
})
}
return employeeScores, nil
}
// 将得分字符串转化为浮动数
func parseScore(scoreStr string) (float64, error) {
var score float64
_, err := fmt.Sscanf(scoreStr, "%f", &score)
if err != nil {
return 0, err
}
return score, nil
}
// 根据总分计算等级
func calculateGrade(total float64) string {
if total >= 270 {
return "优秀"
} else if total >= 240 {
return "良好"
} else if total >= 210 {
return "中等"
}
return "差"
}
```
- **创建打分服务**
在 GoZero 中，我们将创建一个服务来处理 API 请求，读取 Excel 文件并返回打分结果。可以在 `service` 包下创建一个文件来处理这个逻辑。```go
// service/score_service.go
package service
import (
"context"
"fmt"
"my-gozero-project/excel"
)
type ScoreService struct{}
func (s *ScoreService) GetScores(ctx context.Context, filePath string) ([]excel.EmployeeScore, error) {
// 读取 Excel 文件并返回评分
employeeScores, err := excel.ReadExcel(filePath)
if err != nil {
return nil, fmt.Errorf("处理 Excel 文件失败: %v", err)
}
return employeeScores, nil
}
```
- **编写 API 路由和控制器**
GoZero 提供了一个强大的路由和控制器机制，我们将设置一个 API 路由，用来接收文件路径并返回评分结果。```go
// api/scorehandler.go
package api
import (
"context"
"fmt"
"my-gozero-project/service"
"github.com/tal-tech/go-zero/rest"
)
type ScoreHandler struct {
scoreService service.ScoreService
}
func (h *ScoreHandler) HandleRequest(w rest.ResponseWriter, r *rest.Request) {
// 获取 Excel 文件路径
filePath := r.URL.Query().Get("file")
if filePath == "" {
w.WriteErrorString(400, "文件路径不能为空")
return
}
// 获取员工绩效评分
scores, err := h.scoreService.GetScores(context.Background(), filePath)
if err != nil {
w.WriteErrorString(500, fmt.Sprintf("处理文件失败: %v", err))
return
}
// 返回评分结果
w.WriteJson(scores)
}
```
4.4 启动服务器
最后，在 `main.go` 中启动服务器并注册路由：```go
// main.go
package main
import (
"my-gozero-project/api"
"my-gozero-project/service"
"github.com/tal-tech/go-zero/rest"
)
func main() {
// 初始化服务
scoreService := service.ScoreService{}
handler := api.ScoreHandler{scoreService}
// 创建路由并启动
server := rest.MustNewServer(rest.RestConf{})
server.AddRoute(rest.Route{
Method: "GET",
Path: "/api/score",
Handler: handler.HandleRequest,
})
server.Start()
}
```
5. 运行程序
保存代码后，运行 GoZero 项目：
```bash
go run main.go
```
然后，你可以通过浏览器或 Postman 向 `http://localhost:8888/api/score?file=your_file_path.xlsx\` 发送请求来查看打分结果。
6. 结语
chmod -R 777 jx
chmod -x jx
chmod +x jx
./jx
通过本文的介绍，我们演示了如何使用 GoZero 框架和 Excelize 库来实现读取绩效表格并自动打分的功能。这个流程可以应用于各种企业的绩效考核系统，通过自动化处理，提高效率和准确性。如果你有更复杂的评分规则或数据处理需求，可以在此基础上进行扩展。
