Excel第一行未被跳过，而是GetSheetRows默认从第1行读取；需显式指定起始行（如row=2）并用GetRow逐行处理，避免空行干扰和合并单元格导致的空字符串问题。
用 excelize 读取 Excel 文件时，为什么第一行总是被跳过或解析错？
常见现象是调用 f.GetSheetRows("Sheet1") 后，拿到的首条数据看起来像表头，但实际业务中需要跳过它——其实不是库跳过了，而是 GetSheetRows 默认从第 1 行开始读（Excel 行号从 1 起），而你没显式控制起始行。
正确做法是先定位有效数据起始行（比如第 2 行开始才是数据），再逐行处理：
// 假设第1行为表头，从第2行开始读
for row := 2; row <= f.GetSheetMap()["Sheet1"]; row++ {
cells, err := f.GetRow("Sheet1", row)
if err != nil || len(cells) == 0 {
continue // 空行或读取出错，跳过
}
// cells[0] 是 A 列，依此类推
}
- 别依赖
GetSheetRows的返回切片顺序，它会把空行也塞进去；GetRow更可控 - 注意 Excel 列索引是字符串（"A", "B"）或数字（0-based），但
GetRow返回的是按列顺序排列的[]string，和 Excel 界面列序一致 - 如果 Excel 有合并单元格，
GetRow会返回空字符串（""），需提前用f.GetMergeCells()检查并补值
字段映射到 struct 时，如何避免类型转换 panic？
Excel 单元格内容全是字符串，但数据库字段可能是 int64、time.Time 或 bool。直接用 strconv.Atoi 或 time.Parse 容易 panic，尤其当 Excel 里填了“暂无”“/”或空格时。
推荐用带校验的转换函数封装，例如：
立即学习“go语言免费学习笔记（深入）”；
func parseInt(s string) (int64, error) {
s = strings.TrimSpace(s)
if s == "" || s == "-" || s == "N/A" {
return 0, nil // 或返回 zero value + no error，由业务决定是否允许空
}
return strconv.ParseInt(s, 10, 64)
}
func parseTime(s string) (time.Time, error) {
s = strings.TrimSpace(s)
for _, layout := range []string{
"2006-01-02",
"2006/01/02",
"2006-01-02 15:04:05",
} {
if t, err := time.Parse(layout, s); err == nil {
return t, nil
}
}
return time.Time{}, fmt.Errorf("invalid date format: %s", s)
}
- 永远对输入
strings.TrimSpace，Excel 导出常带首尾空格 - 不要用
fmt.Sscanf解析数字，它对非数字输入静默失败，不如strconv显式报错 - 时间解析必须覆盖多种常见导出格式，Excel 本身不存格式信息，只存显示值
批量插入 MySQL 时，为什么用 INSERT INTO ... VALUES (),()... 比循环 Exec 快 10 倍？
单条 INSERT 在事务中仍要走完整语句解析、权限检查、日志写入流程；而批量拼成一条语句，MySQL 只做一次解析，网络往返也从 N 次降到 1 次。
实操建议：
var sql strings.Builder
sql.WriteString("INSERT INTO users (name, age, created_at) VALUES ")
values := make([]interface{}, 0, 1000)
for i, row := range rows {
if i > 0 {
sql.WriteString(", ")
}
sql.WriteString("(?, ?, ?)")
values = append(values, row.Name, row.Age, row.CreatedAt)
}
_, err := db.Exec(sql.String(), values...)
- 单次批量别超过 1000 条，否则可能触发 MySQL 的
max_allowed_packet限制（默认 4MB） - 确保
db.Exec在事务内执行，否则每批提交都是独立事务，性能反而下降 - 如果字段含
NULL，用sql.NullString等类型传参，别传nil，否则driver.Value接口会 panic
导入中途出错时，怎么保证数据库状态可回退、Excel 进度可续传？
真实场景中，Excel 可能上万行，网络抖动、DB 连接断开、某条数据格式非法——全量回滚不现实，但也不能让用户重传整个文件。
关键策略是：分块事务 + 外部进度记录。
- 每 100 行启一个事务，成功后把最后处理的行号写入 Redis 或本地文件（如
import_progress_{job_id}.json） - 结构体里加
RowNumber int `excel:"row"`字段，方便出错时定位原始位置 - 错误日志必须包含
RowNumber、原始cells内容、具体错误（如 “age=‘abc’: strconv.ParseInt: parsing \“abc\”: invalid syntax”） - 不要在事务里做 HTTP 请求或文件 IO，这些操作失败不应导致事务回滚，应拆到事务外
最易被忽略的是 Excel 单元格的「显示值」和「原始值」差异：比如日期在 Excel 里显示为“2024-03-15”，底层可能是浮点数 45366，用 GetCellFloat 才能正确还原——不处理这个，时间字段入库永远错。
