本文详解 go 中使用 xlsx 包时因未初始化 *xlsx.row 导致 runtime panic 的根本原因，并提供安全创建 excel 单元格的完整实践方案，包括内存分配、sheet 构建流程及常见错误规避方法。
本文详解 go 中使用 xlsx 包时因未初始化 *xlsx.row 导致 runtime panic 的根本原因，并提供安全创建 excel 单元格的完整实践方案，包括内存分配、sheet 构建流程及常见错误规避方法。
在 Go 中使用 tealeg/xlsx 包生成 Excel 文件时，一个高频崩溃原因是：*对未初始化的 `xlsx.Row指针调用AddCell()方法**，触发panic: runtime error: invalid memory address or nil pointer dereference`。该 panic 并非逻辑错误，而是底层硬件检测到对空地址（0x0）的非法读写后，由 Go 运行时主动中止程序。
关键问题在于：你声明了 var row *xlsx.Row，但未赋予其有效内存地址——此时 row == nil。后续执行 row.AddCell() 实际等价于 (*nil).AddCell()，Go 无法解引用空指针，立即 panic。
✅ 正确做法不是用 new(xlsx.Row) —— 因为 xlsx.Row 是一个结构体，其 AddCell() 方法依赖于内部字段（如 sheet、cells 等）已正确初始化，而 new() 仅做零值分配，无法满足 xlsx 包的构造契约。官方文档和源码明确指出：*xlsx.Row 实例*必须通过 `xlsx.Sheet.AddRow()创建**，而非手动new或&xlsx.Row{}`。
以下是安全、可运行的完整示例：
package main
import (
"log"
"github.com/tealeg/xlsx"
)
func main() {
// 1. 创建工作簿
file := xlsx.NewFile()
// 2. 添加工作表（必须！）
sheet, err := file.AddSheet("Data")
if err != nil {
log.Fatal(err)
}
// 3. ✅ 正确创建 Row：通过 Sheet.AddRow()
row := sheet.AddRow()
// 4. ✅ 正确添加 Cell：通过 Row.AddCell()
cell := row.AddCell()
cell.Value = "Hello, Excel!"
// 5. 保存文件
if err := file.Save("output.xlsx"); err != nil {
log.Fatal(err)
}
}
⚠️ 注意事项：
- *禁止直接 `var row xlsx.Row
后调用row.AddCell()**：row` 为 nil，必 panic； -
禁止
row := new(xlsx.Row)或row := &xlsx.Row{}：AddCell()内部会访问未初始化的row.sheet等字段，仍 panic； - *必须通过
sheet.AddRow()获取 `xlsx.Row`**：该方法完成完整初始化（包括绑定 sheet、初始化 cells 切片等）； -
*xlsx.Sheet同样需通过file.AddSheet()创建，不可var sheet *xlsx.Sheet； - 若需批量写入，应复用
row := sheet.AddRow()循环调用，每次返回新*xlsx.Row。
总结：Go 的 nil 指针 panic 是强类型安全的体现。tealeg/xlsx 的对象生命周期严格依赖工厂方法（如 AddSheet() / AddRow() / AddCell()），跳过任一环节都会破坏内部状态。始终遵循「由外向内」的构造顺序：File → Sheet → Row → Cell，即可彻底规避此类 panic。
