如何在Java生成CSV/XLS时避免Excel去除数字开头的零

你遇到的问题本质是Excel的自动格式识别——即使CSV里存的是带前导零的字符串，Excel会自动把它判定为数字并去掉前导零。下面是几个实用的解决方法：

方法一：在字符串前添加单引号前缀 #

直接在POJO的字段取值时给字符串加单引号，Excel会自动隐藏单引号并保留完整的文本格式：

public class FepAccount { 
    @CsvBindByName(column = "ITEM_NUMBER")
    protected String itemNumber;
        
    public String getItemNumber() {
        // 给字符串前加单引号
        return itemNumber != null ? "'" + itemNumber : itemNumber;
    }
    public void setItemNumber(String itemNumber) {
        this.itemNumber = itemNumber;
    }
}

这种方式简单直接，CSV文件里的内容会是'005292，Excel打开后显示005292。

方法二：使用OpenCSV自定义转换器 #

如果不想修改POJO的get方法，可以用OpenCSV的自定义转换器来处理特定列：

1. 先创建一个转换器类：

import com.opencsv.bean.AbstractBeanField;
import com.opencsv.exceptions.CsvDataTypeMismatchException;

public class LeadingZeroTextConverter extends AbstractBeanField<String> {
    @Override
    protected String convert(String value) throws CsvDataTypeMismatchException {
        // 为空时直接返回，不为空则添加单引号前缀
        return value != null ? "'" + value : null;
    }
}

2. 在POJO的字段注解中指定这个转换器：

public class FepAccount { 
    @CsvBindByName(column = "ITEM_NUMBER", converter = LeadingZeroTextConverter.class)
    protected String itemNumber;
        
    // 原有的getter和setter不变
    public String getItemNumber() {
        return itemNumber;
    }
    public void setItemNumber(String itemNumber) {
        this.itemNumber = itemNumber;
    }
}

这种方式更符合代码解耦的原则，适合需要处理多个类似字段的场景。

方法三：使用等号+双引号包裹字符串 #

另一种方式是用="005292"的格式写入，Excel会将其识别为文本并保留前导零，这种方式的转换器可以这么写：

public class LeadingZeroTextConverter extends AbstractBeanField<String> {
    @Override
    protected String convert(String value) throws CsvDataTypeMismatchException {
        return value != null ? "=\"" + value + "\"" : null;
    }
}

CSV里的内容会变成="005292"，Excel打开后显示005292，且单元格格式为文本。

注意事项 #

• 这些修改只会影响CSV文件的内容，Java代码中存储的itemNumber值还是原始的带前导零字符串，不会被修改。
• 如果用其他工具打开CSV（比如记事本），会看到单引号或等号前缀，但Excel会正确处理并隐藏这些标记。

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