使用fscanf扫描集转换无法读取CSV数据，求排查方案

问题描述 #

我正在开发读取逗号分隔（CSV）文件的C程序，调试时发现：使用指定fscanf扫描集格式读取数据时，newNode结构体完全为空，但测试文件中使用类似代码（仅字段名不同）可正常读取样本输入。改用%s格式能正常读取整行。

样本输入 #

Doe,John,1,23,2000,CS-BS,Junior
Bar,Foo,4,56,2000,CS-BS,Junior

涉及文件 #

• functions.h
• functions.c
• driver.c
• 可正常运行的测试代码

问题分析与解决方案 #

1. 扫描集格式匹配错误 #

fscanf扫描集如果没正确处理CSV的逗号分隔规则，会导致读取失败。比如仅用%[^,]读取字段但未跳过后续逗号，或扫描集后未匹配逗号的位置，会让后续读取全部错位，最终结构体无有效数据。

错误示例：

// 未正确处理逗号，导致后续读取失败
fscanf(fp, "%[^,],%[^,],%d,...", newNode->lastName, newNode->firstName, &newNode->id, ...);

修正写法：
给扫描集添加长度限制（防止数组溢出），并确保每个字段后正确匹配逗号：

// 假设结构体中字符数组长度为50
if (fscanf(fp, "%49[^,],%49[^,],%d,%d,%d,%49[^,],%49[^\n]", 
           newNode.lastName, newNode.firstName, 
           &newNode.id, &newNode.age, &newNode.year, 
           newNode.major, newNode.grade) == 7) {
    // 读取成功逻辑
} else {
    // 读取失败，检查格式或文件内容
}

2. 结构体字符数组未初始化/溢出 #

如果结构体中的字符数组未初始化，或扫描集读取的内容超出数组长度，会导致内存污染，表现为结构体“为空”（实际是乱码或未正确赋值）。

解决方法：
定义结构体时给字符数组设置足够长度，且读取时限制输入长度：

typedef struct {
    char lastName[50];
    char firstName[50];
    int id;
    int age;
    int year;
    char major[20];
    char grade[20];
} Node;

3. 文件指针位置异常 #

如果文件打开后未定位到起始位置，或之前的读取操作残留了指针位置，会导致fscanf从错误位置开始读取，自然读不到数据。

解决方法：
读取前重置文件指针到开头：

rewind(fp);

4. 格式符与字段类型不匹配 #

若整数字段用%[^,]读取，或字符串字段用%d，会导致fscanf匹配失败，后续所有字段都无法正确赋值。必须严格对应字段类型：

• 字符串字段：%[^,]（加长度限制）
• 整数字段：%d

更鲁棒的替代方案：先读整行再拆分 #

既然fgets（比%s更安全，能读取带空格的行）可以正常读整行，推荐先读取整行到缓冲区，再用strtok拆分字段，这种方式能避免fscanf的格式匹配陷阱：

char line[256];
Node newNode;
while (fgets(line, sizeof(line), fp) != NULL) {
    // 去掉换行符
    line[strcspn(line, "\n")] = '\0';
    
    // 拆分第一个字段
    char *token = strtok(line, ",");
    strncpy(newNode.lastName, token, sizeof(newNode.lastName)-1);
    newNode.lastName[sizeof(newNode.lastName)-1] = '\0';
    
    // 拆分第二个字段
    token = strtok(NULL, ",");
    strncpy(newNode.firstName, token, sizeof(newNode.firstName)-1);
    newNode.firstName[sizeof(newNode.firstName)-1] = '\0';
    
    // 整数字段转换
    token = strtok(NULL, ",");
    newNode.id = atoi(token);
    
    // 其他字段同理处理
}

内容的提问来源于stack exchange，提问作者csm0104