C#中的Base64：字符串编码与解码示例

C#中的Base64：如何轻松编码和解码字符串

您是否曾遇到过需要通过文本协议传输二进制数据、在JSON中发送图片或以可读形式保存哈希值的情况？这正是Base64大显身手的时候——这是一种经典、可靠且安全的格式，能将任何字节转换为安全的文本。

“How do I encode and decode a base64 string?”这个问题是Stack Overflow上最热门的问题之一（拥有数万次浏览）。这并不奇怪：在C#中处理Base64看似简单，但处处暗藏陷阱。今天我们将从A到Z全面解析：从基础示例到实际生产环境中的案例。

什么是Base64，为什么需要它？

Base64是一种将二进制数据（字节）表示为ASCII字符串的方式。其字母表由64个字符组成：A-Z、a-z、0-9，加上'+'和'/'符号。字符串末尾通常会添加'='符号用于对齐。

应用场景：

\n
• 在JSON/XML中传输数据——二进制数据不能直接插入，只能以字符串形式存在
\n
• 身份验证——Basic Auth使用Base64编码用户名和密码
\n
• 在数据库中存储图片——小图片直接以Base64形式存储在数据库中
\n
• 电子邮件附件——MIME格式要求对二进制文件使用Base64
\n

在C#中，这一切都由System.Convert类负责——它是您处理Base64的主要工具。

如何在C#中将字符串编码为Base64

最常见的场景：您有一个普通字符串（例如"Hello, World!"），并希望获得其Base64表示形式。

操作如下：

using System;\nusing System.Text;\n\nstring original = "Hello, World!";\nbyte[] bytes = Encoding.UTF8.GetBytes(original);\nstring base64 = Convert.ToBase64String(bytes);\n\nConsole.WriteLine(base64); // 输出：SGVsbG8sIFdvcmxkIQ==

重要提示：Base64处理的是字节，而不是字符串。因此，我们首先将字符串转换为字节数组（使用UTF-8编码），然后对这些字节进行编码。

为什么使用UTF-8而不是ASCII？因为UTF-8支持所有Unicode字符，包括西里尔字母、汉字和表情符号。如果您对俄语字符串使用ASCII，数据将会丢失。

如何将Base64解码回字符串

反向过程——解码——看起来是对称的：

using System;\nusing System.Text;\n\nstring base64 = "SGVsbG8sIFdvcmxkIQ==";\nbyte[] bytes = Convert.FromBase64String(base64);\nstring decoded = Encoding.UTF8.GetString(bytes);\n\nConsole.WriteLine(decoded); // 输出：Hello, World!

请注意：如果您使用UTF-8编码字符串，那么也必须使用UTF-8进行解码。否则您将得到乱码。

处理二进制数据（图片、文件）

Base64不仅限于字符串。您可以编码任何二进制数据——例如图片或PDF。

示例：将字节数组编码为Base64

byte[] imageBytes = File.ReadAllBytes("photo.jpg");\nstring base64Image = Convert.ToBase64String(imageBytes);\n\n// 现在可以将字符串保存到JSON或通过API发送\nConsole.WriteLine($"Base64字符串长度：{base64Image.Length} 个字符");

解码回文件：

string base64Image = "..."; // 您的字符串\nbyte[] imageBytes = Convert.FromBase64String(base64Image);\nFile.WriteAllBytes("decoded_photo.jpg", imageBytes);

重要提示：Base64会使数据大小增加约33%。如果您有一张1MB的图片，编码后其字符串形式将约为1.33MB。

常见错误及如何避免

即使是经验丰富的开发人员有时也会在Base64上栽跟头。以下是最常见的陷阱：