在C#开发场景中,直接展示文件的原始字节数往往不够友好,用户很难直观感知到文件的实际大小,因此需要将字节数转换为带有KB、MB、GB等缩写的易读格式。实现这个功能的核心逻辑是按照1024的进制逐级换算单位,同时处理不同量级下的数值格式化问题。

核心实现思路
字节到可读格式的转换遵循以下规则:
- 1KB = 1024字节,1MB = 1024KB,1GB = 1024MB,以此类推,进率为1024
- 按照字节数的大小依次匹配对应的单位,当字节数小于当前单位的最小阈值时,使用上一个单位
- 数值部分保留合理的小数位数,避免过多无意义的零,同时处理边界情况比如0字节的特殊展示
完整实现代码
下面是一个通用的扩展方法,支持将长整型的字节数转换为人类可读的字符串格式:
using System;
public static class FileSizeHelper
{
/// <summary>
/// 将字节数转换为人类可读的带缩写的格式
/// </summary>
/// <param name="bytes">原始字节数</param>
/// <returns>格式化后的文件大小字符串</returns>
public static string GetReadableFileSize(long bytes)
{
// 处理0字节的特殊情况
if (bytes == 0)
{
return "0 B";
}
// 定义所有字节单位,按从小到大排列
string[] units = { "B", "KB", "MB", "GB", "TB", "PB", "EB" };
// 计算当前字节数对应的单位索引
int unitIndex = (int)Math.Floor(Math.Log(bytes, 1024));
// 防止索引超出单位数组范围
if (unitIndex >= units.Length)
{
unitIndex = units.Length - 1;
}
// 计算对应单位的数值
double size = bytes / Math.Pow(1024, unitIndex);
// 格式化数值,保留最多2位小数,去掉末尾的零
string sizeStr = size.ToString("0.##");
return $"{sizeStr} {units[unitIndex]}";
}
}
代码使用示例
可以在获取文件信息后直接调用上述方法,示例如下:
using System;
using System.IO;
class Program
{
static void Main()
{
// 模拟不同的文件字节数
long[] testBytes = { 0, 512, 1536, 2097152, 3221225472, 1099511627776 };
foreach (var bytes in testBytes)
{
string readableSize = FileSizeHelper.GetReadableFileSize(bytes);
Console.WriteLine($"原始字节数: {bytes}, 可读格式: {readableSize}");
}
}
}
上述示例的运行结果会依次输出0 B、512 B、1.5 KB、2 MB、3 GB、1 TB,符合预期的可读格式要求。
注意事项
- 该方法使用
long类型接收字节数,支持最大到9EB左右的字节数,满足绝大多数场景的需求 - 数值格式化使用
0.##的格式,当小数部分为0时会自动省略,比如2.00 MB会显示为2 MB - 如果业务需要固定保留1位或2位小数,可以调整
ToString方法的格式字符串,比如0.0#保留1到2位小数