首页 > Golang > Go教程

Golang如何开发一个简易的博客系统实现文章发布与展示功能

时间：2025-07-01 16:32:34 324浏览收藏

Golang不知道大家是否熟悉？今天我将给大家介绍《Golang如何开发一个简易的博客系统实现文章发布与展示功能》，这篇文章主要会讲到等等知识点，如果你在看完本篇文章后，有更好的建议或者发现哪里有问题，希望大家都能积极评论指出，谢谢！希望我们能一起加油进步！

博客系统的核心功能包括文章的CRUD操作、模板渲染、分页、搜索和评论功能。1. 数据模型设计：创建包含id、title、content、author、created_at、updated_at字段的文章表；2. CRUD实现：使用INSERT、SELECT、UPDATE、DELETE语句完成文章的增删改查；3. 模板引擎：通过html/template包加载HTML模板并渲染文章数据；4. 分页显示：结合LIMIT和OFFSET查询指定页数据，并在模板中展示分页链接；5. 搜索功能：通过LIKE语句实现关键词搜索，并展示匹配结果；6. 评论功能：创建评论表结构，实现评论提交、存储及在文章页面展示评论列表。

Golang开发简易博客系统，核心在于搭建一个能够处理HTTP请求、连接数据库、渲染模板的服务器。文章发布和展示是基本功能，需要设计好数据模型和路由。

首先，我们需要明确博客系统的基本功能：文章的创建、编辑、删除和展示。其次，选择合适的数据库存储文章数据，例如SQLite、MySQL或PostgreSQL。最后，使用Golang的模板引擎渲染页面。

数据库设计：文章表结构应该如何定义？

文章表是博客系统的核心，需要存储文章的标题、内容、作者、发布时间等信息。一个典型的文章表结构如下：

CREATE TABLE articles (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    title VARCHAR(255) NOT NULL,
    content TEXT NOT NULL,
    author VARCHAR(255) NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

id 是主键，自增长；title 是文章标题；content 是文章内容；author 是作者；created_at 是创建时间；updated_at 是更新时间。使用Golang的database/sql包可以方便地操作数据库。例如，插入一条新文章：

db, err := sql.Open("sqlite3", "blog.db")
if err != nil {
    log.Fatal(err)
}
defer db.Close()

title := "我的第一篇博客"
content := "这是我的第一篇博客内容。"
author := "张三"

stmt, err := db.Prepare("INSERT INTO articles(title, content, author) VALUES(?, ?, ?)")
if err != nil {
    log.Fatal(err)
}
defer stmt.Close()

_, err = stmt.Exec(title, content, author)
if err != nil {
    log.Fatal(err)
}

fmt.Println("文章发布成功！")

这里使用了SQLite数据库，实际项目中可以根据需要选择其他数据库。

如何实现文章的CRUD操作？

CRUD（Create, Read, Update, Delete）是数据库操作的基本操作。

Create (创建): 如上例所示，使用INSERT语句向数据库中插入新的文章。
Read (读取): 使用SELECT语句从数据库中查询文章。例如，查询所有文章：

rows, err := db.Query("SELECT id, title, content, author, created_at FROM articles")
if err != nil {
    log.Fatal(err)
}
defer rows.Close()

for rows.Next() {
    var id int
    var title, content, author string
    var createdAt time.Time
    err = rows.Scan(&id, &title, &content, &author, &createdAt)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("ID: %d, Title: %s, Author: %s, Created At: %s\n", id, title, author, createdAt)
}

err = rows.Err()
if err != nil {
    log.Fatal(err)
}

Update (更新): 使用UPDATE语句更新数据库中的文章。例如，更新文章标题：

stmt, err := db.Prepare("UPDATE articles SET title = ? WHERE id = ?")
if err != nil {
    log.Fatal(err)
}
defer stmt.Close()

newTitle := "更新后的标题"
articleID := 1

_, err = stmt.Exec(newTitle, articleID)
if err != nil {
    log.Fatal(err)
}

fmt.Println("文章更新成功！")

Delete (删除): 使用DELETE语句从数据库中删除文章。例如，删除指定ID的文章：

stmt, err := db.Prepare("DELETE FROM articles WHERE id = ?")
if err != nil {
    log.Fatal(err)
}
defer stmt.Close()

articleID := 1

_, err = stmt.Exec(articleID)
if err != nil {
    log.Fatal(err)
}

fmt.Println("文章删除成功！")

如何使用Golang的模板引擎展示文章？

Golang的html/template包提供了强大的模板引擎，可以方便地将数据渲染到HTML页面中。首先，创建一个HTML模板文件，例如article.html：




    {{.Title}}


    {{.Title}}
    作者：{{.Author}}，发布时间：{{.CreatedAt}}
    
    {{.Content}}

然后，在Golang代码中加载模板并渲染数据：

type Article struct {
    ID        int
    Title     string
    Content   string
    Author    string
    CreatedAt time.Time
}

func viewArticleHandler(w http.ResponseWriter, r *http.Request) {
    articleID := 1 // 假设要查看ID为1的文章

    // 从数据库中查询文章
    db, err := sql.Open("sqlite3", "blog.db")
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
    defer db.Close()

    row := db.QueryRow("SELECT id, title, content, author, created_at FROM articles WHERE id = ?", articleID)
    var article Article
    err = row.Scan(&article.ID, &article.Title, &article.Content, &article.Author, &article.CreatedAt)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }

    // 加载模板
    tmpl, err := template.ParseFiles("article.html")
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }

    // 渲染模板
    err = tmpl.Execute(w, article)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
}

最后，注册路由并启动服务器：

http.HandleFunc("/article", viewArticleHandler)
log.Fatal(http.ListenAndServe(":8080", nil))

这样，访问http://localhost:8080/article就可以看到渲染后的文章页面。

如何处理文章列表的分页显示？

分页显示文章列表可以提高用户体验，避免一次性加载过多数据。

计算总页数: 首先，需要查询数据库中文章的总数量，然后根据每页显示的文章数量计算总页数。

func getTotalArticlesCount(db *sql.DB) (int, error) {
    var count int
    err := db.QueryRow("SELECT COUNT(*) FROM articles").Scan(&count)
    return count, err
}

func calculateTotalPages(totalArticles, articlesPerPage int) int {
    return int(math.Ceil(float64(totalArticles) / float64(articlesPerPage)))
}

查询指定页的文章: 使用LIMIT和OFFSET子句查询指定页的文章。

func getArticlesByPage(db *sql.DB, page, articlesPerPage int) ([]Article, error) {
    offset := (page - 1) * articlesPerPage
    rows, err := db.Query("SELECT id, title, content, author, created_at FROM articles ORDER BY created_at DESC LIMIT ? OFFSET ?", articlesPerPage, offset)
    if err != nil {
        return nil, err
    }
    defer rows.Close()

    var articles []Article
    for rows.Next() {
        var article Article
        err := rows.Scan(&article.ID, &article.Title, &article.Content, &article.Author, &article.CreatedAt)
        if err != nil {
            return nil, err
        }
        articles = append(articles, article)
    }
    return articles, nil
}

渲染分页链接: 在模板中渲染分页链接，让用户可以方便地切换页面。


    {{if .HasPrevious}}
        上一页
    {{end}}

    {{range .Pages}}
        {{.}}
    {{end}}

    {{if .HasNext}}
        下一页
    {{end}}

在Golang代码中，需要将分页信息传递给模板：

type PageData struct {
    Articles     []Article
    CurrentPage  int
    TotalPages   int
    Pages        []int
    HasPrevious  bool
    HasNext      bool
    PreviousPage int
    NextPage     int
}

func articlesListHandler(w http.ResponseWriter, r *http.Request) {
    pageStr := r.URL.Query().Get("page")
    page, err := strconv.Atoi(pageStr)
    if err != nil || page < 1 {
        page = 1
    }

    articlesPerPage := 10

    db, err := sql.Open("sqlite3", "blog.db")
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
    defer db.Close()

    totalArticles, err := getTotalArticlesCount(db)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }

    totalPages := calculateTotalPages(totalArticles, articlesPerPage)

    articles, err := getArticlesByPage(db, page, articlesPerPage)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }

    pageData := PageData{
        Articles:     articles,
        CurrentPage:  page,
        TotalPages:   totalPages,
        HasPrevious:  page > 1,
        HasNext:      page < totalPages,
        PreviousPage: page - 1,
        NextPage:     page + 1,
    }

    // 生成页码列表
    var pages []int
    for i := 1; i <= totalPages; i++ {
        pages = append(pages, i)
    }
    pageData.Pages = pages

    tmpl, err := template.ParseFiles("articles_list.html")
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }

    err = tmpl.Execute(w, pageData)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
}

如何实现简单的文章搜索功能？

实现文章搜索功能，需要允许用户输入关键词，并在数据库中搜索包含该关键词的文章。

创建搜索表单: 在HTML页面中创建一个搜索表单。

处理搜索请求: 在Golang代码中处理搜索请求，从URL参数中获取关键词，并在数据库中执行搜索。

func searchArticlesHandler(w http.ResponseWriter, r *http.Request) {
    keyword := r.URL.Query().Get("keyword")

    db, err := sql.Open("sqlite3", "blog.db")
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
    defer db.Close()

    // 使用 LIKE 语句进行模糊搜索
    query := "%" + keyword + "%"
    rows, err := db.Query("SELECT id, title, content, author, created_at FROM articles WHERE title LIKE ? OR content LIKE ?", query, query)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
    defer rows.Close()

    var articles []Article
    for rows.Next() {
        var article Article
        err := rows.Scan(&article.ID, &article.Title, &article.Content, &article.Author, &article.CreatedAt)
        if err != nil {
            http.Error(w, err.Error(), http.StatusInternalServerError)
            return
        }
        articles = append(articles, article)
    }

    // 将搜索结果传递给模板
    tmpl, err := template.ParseFiles("search_results.html")
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }

    err = tmpl.Execute(w, articles)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
}

显示搜索结果: 在HTML模板中显示搜索结果。




    搜索结果


    搜索结果
    
        {{range .}}
            
                {{.Title}}
            
        {{end}}

如何添加评论功能？

评论功能可以增加博客的互动性。

创建评论表: 创建一个评论表，存储评论的内容、作者、发布时间以及所属的文章ID。

CREATE TABLE comments (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    article_id INTEGER NOT NULL,
    author VARCHAR(255) NOT NULL,
    content TEXT NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (article_id) REFERENCES articles(id)
);

创建评论表单: 在文章页面中创建一个评论表单。

处理评论提交: 在Golang代码中处理评论提交请求，将评论保存到数据库中。

func addCommentHandler(w http.ResponseWriter, r *http.Request) {
    articleIDStr := r.FormValue("article_id")
    articleID, err := strconv.Atoi(articleIDStr)
    if err != nil {
        http.Error(w, "Invalid article ID", http.StatusBadRequest)
        return
    }
    author := r.FormValue("author")
    content := r.FormValue("content")

    db, err := sql.Open("sqlite3", "blog.db")
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
    defer db.Close()

    stmt, err := db.Prepare("INSERT INTO comments(article_id, author, content) VALUES(?, ?, ?)")
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
    defer stmt.Close()

    _, err = stmt.Exec(articleID, author, content)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }

    // 重定向回文章页面
    http.Redirect(w, r, "/article?id="+articleIDStr, http.StatusSeeOther)
}

显示评论: 在文章页面中显示评论列表。

func getCommentsByArticleID(db *sql.DB, articleID int) ([]Comment, error) {
    rows, err := db.Query("SELECT id, author, content, created_at FROM comments WHERE article_id = ?", articleID)
    if err != nil {
        return nil, err
    }
    defer rows.Close()

    var comments []Comment
    for rows.Next() {
        var comment Comment
        err := rows.Scan(&comment.ID, &comment.Author, &comment.Content, &comment.CreatedAt)
        if err != nil {
            return nil, err
        }
        comments = append(comments, comment)
    }
    return comments, nil
}

在文章模板中显示评论：

评论列表

    {{range .Comments}}
        
            {{.Author}}：{{.Content}}
            ({{ .CreatedAt }})
        
    {{end}}

这些步骤可以帮助你用Golang构建一个简易的博客系统，实现文章发布与展示功能。

到这里，我们也就讲完了《Golang如何开发一个简易的博客系统实现文章发布与展示功能》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于golang,博客系统的知识点！

golang 博客系统

Golang如何开发一个简易的博客系统 实现文章发布与展示功能

数据库设计：文章表结构应该如何定义？

如何实现文章的CRUD操作？

如何使用Golang的模板引擎展示文章？

{{.Title}}

如何处理文章列表的分页显示？

如何实现简单的文章搜索功能？

搜索结果

如何添加评论功能？

评论列表

Golang如何开发一个简易的博客系统实现文章发布与展示功能