本文旨在解决在 Go 语言中，将 SQL 查询结果动态追加到切片时遇到的变量作用域问题。通过分析常见错误原因，结合代码示例，详细讲解如何正确地在循环中将数据追加到切片，并避免因变量声明冲突导致的问题，从而实现将查询结果传递给模板进行展示。
在 Go 语言中，向切片追加数据是常见的操作，尤其是在处理数据库查询结果时。然而，如果在循环内部错误地使用短变量声明，可能会导致数据无法正确追加到切片，甚至出现编译错误。本文将通过一个实际的例子，讲解如何避免这类问题，并提供正确的解决方案。
问题分析
以下是一个典型的场景，从数据库查询帖子标题，并将结果存储到 Post 类型的切片中：
type Post struct {
Title string
}
func landing(w http.ResponseWriter, r *http.Request) {
posts := make([]Post, 0)
conn := OpenConnection()
defer conn.Close()
rows, err := conn.Query("SELECT p.title FROM posts p LIMIT 100")
if err != nil {
fmt.Println(err)
} else {
for rows.Next() {
var title string
rows.Scan(&title)
posts := append(posts, Post{Title: title}) // 错误发生在此处
}
}
t, _ := template.ParseFiles("home.html")
t.Execute(w, posts)
}
func main() {
http.HandleFunc("/", landing)
}上述代码在编译时会提示 posts declared and not used。即使在 append 调用后打印 posts，也会发现每次迭代都重置了 posts 的值，而不是追加。这是因为在 for 循环内部，使用了短变量声明 posts := append(posts, Post{Title: title})，导致在循环内部创建了一个新的 posts 变量，而不是使用外部声明的 posts 切片。
解决方案
要解决这个问题，需要理解 Go 语言中变量的作用域。在 for 循环内部，应该使用赋值操作符 =，而不是短变量声明 :=，以修改外部声明的 posts 切片。
正确的代码如下：
type Post struct {
Title string
}
func landing(w http.ResponseWriter, r *http.Request) {
posts := make([]Post, 0)
conn := OpenConnection()
defer conn.Close()
rows, err := conn.Query("SELECT p.title FROM posts p LIMIT 100")
if err != nil {
fmt.Println(err)
} else {
for rows.Next() {
var title string
rows.Scan(&title)
posts = append(posts, Post{Title: title}) // 使用赋值操作符
}
}
t, _ := template.ParseFiles("home.html")
t.Execute(w, posts)
}
func main() {
http.HandleFunc("/", landing)
}在这个修改后的代码中，posts = append(posts, Post{Title: title}) 使用了赋值操作符 =，将新的 Post 结构体追加到外部声明的 posts 切片中。这样，每次迭代都会将新的帖子标题追加到切片中，最终将完整的查询结果传递给模板进行展示。
总结与注意事项
- 变量作用域： 理解 Go 语言中变量的作用域至关重要。在循环内部，如果需要修改外部声明的变量，应该使用赋值操作符 =，而不是短变量声明 :=。
- 短变量声明： 短变量声明 := 会在当前作用域内创建一个新的变量。如果该变量与外部变量同名，则会隐藏外部变量。
- 切片操作： append 函数会返回一个新的切片。如果原切片的容量不足以容纳新元素，append 函数会创建一个新的底层数组，并将原切片的数据复制到新的数组中。
通过理解变量作用域和正确使用 append 函数，可以避免在 Go 语言中处理切片时遇到的常见问题，从而编写出更加健壮和可维护的代码。
