使用Go语言开发任务待办清单Web应用

2025-09-16 08:19:15 作者：程序员爱钓鱼

在学习 Go 的过程中,一个非常适合入门的 Web 项目就是 TodoList（任务待办清单）,本文将为大家详细介绍一下具体实现方法,希望对大家有所帮助

在学习 Go 的过程中，一个非常适合入门的 Web 项目就是 TodoList（任务待办清单）。它功能简单，但涵盖了 HTTP 路由、数据存储、前后端交互 等核心知识点。本篇我们将实现一个基于 Go 标准库 + HTML 模板 的 TodoList 应用。

一、项目目标

实现一个简易的 任务待办清单 Web 应用：

查看任务列表
添加任务
删除任务
标记任务完成/未完成
数据持久化（存储在 JSON 文件）

二、系统设计

数据结构

type Task struct {
    ID        int    `json:"id"`
    Title     string `json:"title"`
    Completed bool   `json:"completed"`
}

路由设计

路径	方法	功能
/	GET	展示任务列表
/add	POST	添加任务
/delete?id=	GET	删除任务
/toggle?id=	GET	切换完成状态

存储方式

使用 JSON 文件存储所有任务 (tasks.json)
每次操作时更新文件，保证数据持久化

三、完整代码示例

文件名：main.go

package main

import (
	"encoding/json"
	"html/template"
	"net/http"
	"os"
	"strconv"
	"sync"
)

type Task struct {
	ID        int    `json:"id"`
	Title     string `json:"title"`
	Completed bool   `json:"completed"`
}

var (
	tasks    []Task
	dataFile = "tasks.json"
	mutex    sync.Mutex
)

// 加载任务
func loadTasks() {
	file, err := os.ReadFile(dataFile)
	if err != nil {
		tasks = []Task{}
		return
	}
	_ = json.Unmarshal(file, &tasks)
}

// 保存任务
func saveTasks() {
	data, _ := json.MarshalIndent(tasks, "", "  ")
	_ = os.WriteFile(dataFile, data, 0644)
}

// 首页：显示任务列表
func indexHandler(w http.ResponseWriter, r *http.Request) {
	tmpl := `
	<!DOCTYPE html>
	<html>
	<head>
		<meta charset="UTF-8">
		<title>Todo List</title>
		<style>
			body { font-family: Arial, sans-serif; margin: 20px; }
			.done { text-decoration: line-through; color: gray; }
		</style>
	</head>
	<body>
		<h1>任务待办清单 ✅</h1>
		<form method="POST" action="/add">
			<input type="text" name="title" placeholder="输入任务..." required>
			<button type="submit">添加</button>
		</form>
		<ul>
			{{range .}}
				<li>
					<a href="/toggle?id={{.ID}}" rel="external nofollow" >
						<span class="{{if .Completed}}done{{end}}">{{.Title}}</span>
					</a>
					<a href="/delete?id={{.ID}}" rel="external nofollow"  style="color:red;">[删除]</a>
				</li>
			{{end}}
		</ul>
	</body>
	</html>`
	t := template.Must(template.New("index").Parse(tmpl))
	_ = t.Execute(w, tasks)
}

// 添加任务
func addHandler(w http.ResponseWriter, r *http.Request) {
	if r.Method == http.MethodPost {
		title := r.FormValue("title")
		if title != "" {
			mutex.Lock()
			id := 1
			if len(tasks) > 0 {
				id = tasks[len(tasks)-1].ID + 1
			}
			tasks = append(tasks, Task{ID: id, Title: title, Completed: false})
			saveTasks()
			mutex.Unlock()
		}
	}
	http.Redirect(w, r, "/", http.StatusFound)
}

// 删除任务
func deleteHandler(w http.ResponseWriter, r *http.Request) {
	idStr := r.URL.Query().Get("id")
	if id, err := strconv.Atoi(idStr); err == nil {
		mutex.Lock()
		for i, t := range tasks {
			if t.ID == id {
				tasks = append(tasks[:i], tasks[i+1:]...)
				break
			}
		}
		saveTasks()
		mutex.Unlock()
	}
	http.Redirect(w, r, "/", http.StatusFound)
}

// 切换任务完成状态
func toggleHandler(w http.ResponseWriter, r *http.Request) {
	idStr := r.URL.Query().Get("id")
	if id, err := strconv.Atoi(idStr); err == nil {
		mutex.Lock()
		for i, t := range tasks {
			if t.ID == id {
				tasks[i].Completed = !tasks[i].Completed
				break
			}
		}
		saveTasks()
		mutex.Unlock()
	}
	http.Redirect(w, r, "/", http.StatusFound)
}

func main() {
	loadTasks()

	http.HandleFunc("/", indexHandler)
	http.HandleFunc("/add", addHandler)
	http.HandleFunc("/delete", deleteHandler)
	http.HandleFunc("/toggle", toggleHandler)

	println("服务器启动：http://localhost:8080")
	_ = http.ListenAndServe(":8080", nil)
}

四、运行效果

启动服务

go run main.go

浏览器访问 http://localhost:8080

输入任务 → 点击“添加” → 列表中出现
点击任务文字 → 切换完成状态（加删除线 ✅）
点击 [删除] → 删除任务

数据保存在 tasks.json 文件，重启服务数据仍然存在。

五、扩展方向

任务编辑功能：修改任务标题
增加截止日期 / 优先级
搜索 & 分类：已完成 / 未完成分组
使用前端框架：Vue/React + Go 后端 API
替换存储：SQLite/MySQL/Postgres

六、总结

这个 TodoList Web 应用示例，涵盖了：

Go 标准库 net/http 的基本用法
HTML 模板 渲染动态页面
JSON 文件持久化
简单的 并发控制（sync.Mutex）

是非常好的 Go Web 开发入门实战案例。

到此这篇关于使用Go语言开发任务待办清单Web应用的文章就介绍到这了,更多相关Go任务待办清单应用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！