C#本地生成Code 39与Code 128条形码：原理、实现与工业打印实战

1. 项目缘起：为什么要在C#项目中自己生成条形码？

最近在做一个仓库管理相关的上位机项目，客户要求所有出入库单据和物料标签都必须打印包含物料编码的条形码。一开始我图省事，想着直接用现成的标签打印机驱动或者调用第三方服务API来生成，但实际跑下来发现两个大问题：一是网络打印服务在工厂内网环境下不稳定，经常因为网络抖动导致打印任务卡住；二是第三方字体或组件在部署到客户工控机时，经常因为系统权限或缺失运行库而报错，最头疼的一次是提示“拒绝访问”，调试了半天才发现是Windows的UAC和OPC服务器权限冲突了。

所以，我决定回归本质，用C#在本地纯代码生成条形码。这样一来，部署就是几个DLL的事儿，不依赖网络，不依赖特定字体，打印流程完全可控。Code 39和Code 128是工业领域最常用的两种一维码制，Code 39因为支持数字和字母，在固定资产管理里很常见；Code 128密度高、校验严谨，在物流和仓储管理中用得更多。这篇文章，我就把从选型、原理到代码实现，再到实际打印和避坑的完整过程梳理一遍，目标就是让你拿到代码稍作修改，就能直接集成到你的WPF、WinForms甚至是.NET Core的后端服务里去。

2. 核心条码制式解析：Code 39与Code 128到底该怎么选？

在动手写代码之前，必须得搞清楚这两种码制的“脾气”，不然很容易选错，导致打印出来的标签扫描枪读不出来，或者读错了。

2.1 Code 39：简单直白的“老大哥”

Code 39，也叫3 of 9 code，它的编码规则非常直观：每个字符由9个元素（5条黑条、4条白条）构成，其中3个是宽元素（宽条或宽空），6个是窄元素。这也就是“3 of 9”这个名字的由来。

它的核心特点与适用场景：

  • 字符集：支持数字0-9，大写字母A-Z，以及特殊字符-,., （空格）,$,/,+,%。注意，它不支持小写字母。如果你要编码的字符串里混入了小写字母，要么提前转换成大写，要么就得换用Code 128。
  • 校验：原生Code 39没有强制校验位。这意味着，如果条码印刷质量差（比如油墨扩散），扫描器有可能误读。为了提高可靠性，行业里衍生出了Code 39 Extended，它通过双字符编码的方式支持了完整的ASCII码，但也会使条码长度增加。更常见的做法是使用带模43校验（Modulo 43 Check Digit）的Code 39，会在数据末尾加一个校验字符。
  • 密度：密度较低。因为每个字符都需要9个元素来表示，所以同样长度的数据，Code 39生成的条码会比Code 128宽很多。
  • 起始/终止符：每个Code 39条码都以一个特殊的星号*作为起始和终止符。在生成条码时，我们不需要手动添加这个星号，但生成图像后，你会看到条码的首尾各有一个星号对应的条空图案。

实操心得：如果你的应用场景是内部固定资产盘点，标签尺寸大，内容只是“设备编号+字母”（比如PC-2024-001），并且扫描环境良好，那么用Code 39就足够了，简单可靠。但如果你要打印在很小的标签上，或者内容包含小写字母和更多符号，就别用它了。

2.2 Code 128：高效严谨的“多面手”

Code 128就复杂得多，也强大得多。它定义了三个不同的字符集（子集）：A、B、C。通过特殊的“切换码”，可以在一个条码中混合使用这些子集，从而实现最高效的编码。

它的核心特点与适用场景：

  • 字符集：
    • 子集A：数字、大写字母、控制字符（如换行、回车）。适合编码以控制字符或大写字母为主的数据。
    • 子集B：数字、大小写字母、常用符号。这是最常用的子集，因为它支持大小写混合的英文文本。
    • 子集C：纯数字对。这是它的“杀手锏”。子集C用一个条码字符来表示两个数字（00-99），这使得编码纯数字数据时，密度是Code 39的近一倍！比如数字123456，在子集C中只用3个条码字符表示。
  • 校验：Code 128强制包含一个校验位。这个校验位是基于一个复杂的加权算法计算出来的，极大地提高了数据的准确性。校验位的计算和添加是生成过程中的核心步骤，后面我们会详细讲。
  • 密度：高。尤其是编码纯数字时，使用子集C的密度无人能及。
  • 起始符：根据选择的子集不同，起始符也不同（START A,START B,START C）。此外，条码还必须包含一个特殊的终止符。

如何选择子集？一个高效的Code 128编码器，应该能自动选择最优的子集序列。基本策略是：遇到连续4个或以上的数字，就切换到子集C；否则，默认使用子集B（因为它最通用）。编码过程中还可以通过切换码（CODE A,CODE B,SHIFT）临时切换。

实操心得：在物流单、药品监管码、产品序列号这些场景下，Code 128几乎是唯一选择。因为它密度高，能节省标签空间；强制校验，保证数据准确；支持完整ASCII，兼容性好。我项目中物料编码是“字母+数字”混合（如P20240822001），虽然开头是字母，但后面跟着长串数字，用Code 128并让编码器自动在子集B和C间切换，生成的条码比Code 39短了将近40%，非常实用。

3. 从零构建：C#生成条形码的核心算法与实现

我们不依赖任何收费组件或需要特殊安装的字体，完全通过System.Drawing（对于.NET Framework）或System.Drawing.Common（对于.NET Core/.NET 5+）来画图实现。这里我以.NET 6的控制台应用为例，创建一个类库项目，你可以轻松引用到WPF或WinForms中。

3.1 项目准备与基础类设计

首先，创建一个新的.NET 6类库项目，安装必要的NuGet包：

dotnet add package System.Drawing.Common

然后，我们设计一个基础抽象类BarcodeGenerator，定义公共接口和属性：

using System.Drawing; namespace BarcodeLib { public abstract class BarcodeGenerator { // 公共属性 public string Data { get; protected set; } public int Height { get; set; } = 80; // 条码高度（像素） public int NarrowBarWidth { get; set; } = 2; // 窄条宽度（像素） public int WideBarWidth { get; set; } = 4; // 宽条宽度（像素，Code39用） public bool IncludeText { get; set; } = true; // 是否在底部显示可读文本 public Color ForeColor { get; set; } = Color.Black; public Color BackColor { get; set; } = Color.White; // 构造函数 protected BarcodeGenerator(string data) { if (string.IsNullOrWhiteSpace(data)) throw new ArgumentException("条码数据不能为空"); Data = data; } // 核心抽象方法：将数据编码为条空序列（true=条，false=空） protected abstract bool[] EncodeData(); // 核心抽象方法：计算条码的总宽度（像素） protected abstract int CalculateTotalWidth(); // 生成Bitmap图像的主方法 public virtual Bitmap GenerateImage() { bool[] pattern = EncodeData(); // 获取编码模式 int totalWidth = CalculateTotalWidth(); int imgWidth = totalWidth; int imgHeight = Height + (IncludeText ? 20 : 0); // 如果显示文本，预留底部空间 Bitmap bmp = new Bitmap(imgWidth, imgHeight); using (Graphics g = Graphics.FromImage(bmp)) { g.Clear(BackColor); int currentX = 0; // 绘制条空 for (int i = 0; i < pattern.Length; i++) { bool isBar = pattern[i]; int barWidth = (i % 2 == 0) ? GetBarWidth(isBar) : GetSpaceWidth(isBar); // 奇数索引是空 if (isBar) // 画条 { using (Brush brush = new SolidBrush(ForeColor)) { g.FillRectangle(brush, currentX, 0, barWidth, Height); } } // 空的部分就是背景色，无需绘制 currentX += barWidth; } // 绘制底部文本 if (IncludeText) { using (Font font = new Font("Arial", 10)) using (Brush textBrush = new SolidBrush(ForeColor)) { SizeF textSize = g.MeasureString(Data, font); float textX = (imgWidth - textSize.Width) / 2; float textY = Height + 2; // 距离条码底部2像素 g.DrawString(Data, font, textBrush, textX, textY); } } } return bmp; } // 子类需要实现的方法：根据是否为宽元素获取当前条/空的宽度 protected abstract int GetBarWidth(bool isWide); protected abstract int GetSpaceWidth(bool isWide); } }

这个基类把绘图、颜色、尺寸等通用逻辑封装好了，子类只需要关注如何把字符串Data转换成bool[]的条空序列，以及如何定义宽窄单元的宽度。

3.2 Code 39生成器的具体实现

Code 39的编码表是固定的，我们可以用一个字典来映射。

using System.Text; namespace BarcodeLib { public class Code39Generator : BarcodeGenerator { // Code 39编码字典：字符 -> 条空模式（'w'代表宽，'n'代表窄） private static readonly Dictionary<char, string> EncodingMap = new Dictionary<char, string>() { {'0', "nnnwwnwnn"}, {'1', "wnnwnnnnw"}, {'2', "nnwwnnnnw"}, {'3', "wnwwnnnnn"}, {'4', "nnnwwnnnw"}, {'5', "wnnwwnnnn"}, {'6', "nnwwwnnnn"}, {'7', "nnnwnnwnw"}, {'8', "wnnwnnwnn"}, {'9', "nnwwnnwnn"}, {'A', "wnnnnwnnw"}, {'B', "nwnnnwnnw"}, {'C', "wnwnnnwnn"}, {'D', "nnnnwwnnw"}, {'E', "wnnnwwnnn"}, {'F', "nwnnwwnnn"}, {'G', "nnnnnwwnw"}, {'H', "wnnnnwwnn"}, {'I', "nwnnnwwnn"}, {'J', "nnnnwwwnn"}, {'K', "wnnnnnnww"}, {'L', "nwnnnnnww"}, {'M', "wnwnnnnwn"}, {'N', "nnnnwnnww"}, {'O', "wnnnwnnwn"}, {'P', "nwnnwnnwn"}, {'Q', "nnnnnnwww"}, {'R', "wnnnnnwwn"}, {'S', "nwnnnnwwn"}, {'T', "nnnnwnwwn"}, {'U', "wwnnnnnnw"}, {'V', "nwwnnnnnw"}, {'W', "wwwnnnnnn"}, {'X', "nwnnwnnnw"}, {'Y', "wwnnwnnnn"}, {'Z', "nwwnwnnnn"}, {'-', "nwnnnnwnw"}, {'.', "wwnnnnwnn"}, {' ', "nwwnnnwnn"}, {'$', "nwnwnwnnn"}, {'/', "nwnwnnnwn"}, {'+', "nwnnnwnwn"}, {'%', "nnnwnwnwn"}, {'*', "nwnnwnwnn"} // 起始/终止符 }; public bool UseMod43Check { get; set; } = false; // 是否启用模43校验 public Code39Generator(string data) : base(data.ToUpper()) // Code39强制大写 { ValidateData(); } private void ValidateData() { foreach (char c in Data) { if (!EncodingMap.ContainsKey(c)) { throw new ArgumentException($"Code 39不支持字符 '{c}'。"); } } } protected override bool[] EncodeData() { StringBuilder patternBuilder = new StringBuilder(); // 1. 添加起始符 '*' patternBuilder.Append(EncodingMap['*']); // 2. 添加数据字符 string dataToEncode = Data; if (UseMod43Check) { dataToEncode += CalculateMod43CheckDigit(Data); } foreach (char c in dataToEncode) { patternBuilder.Append(EncodingMap[c]); } // 3. 添加终止符 '*' patternBuilder.Append(EncodingMap['*']); // 4. 将“w”和“n”的字符串转换为bool数组（true=条，false=空） // Code39的编码字符串是“条空条空...”交替的，长度为9的倍数。 string fullPattern = patternBuilder.ToString(); bool[] result = new bool[fullPattern.Length]; for (int i = 0; i < fullPattern.Length; i++) { // 偶数索引（0,2,4...）是条，奇数索引是空 bool isBar = (i % 2 == 0); bool isWide = (fullPattern[i] == 'w'); // 对于条，isWide为true表示宽条；对于空，isWide为true表示宽空。 // 我们这里只存储“是否为宽单元”的信息，具体宽度由GetBarWidth/GetSpaceWidth决定。 // 为了简化，我们用一个bool表示“是否需要绘制宽单元”。这里存储原始字符。 // 更好的做法是直接存储一个“宽度倍数”的整数。这里我们用bool数组存储“是否为宽单元”。 result[i] = isWide; } return result; } private char CalculateMod43CheckDigit(string data) { int sum = 0; foreach (char c in data) { // 找到字符对应的值（0-42） int value = Array.IndexOf(EncodingMap.Keys.ToArray(), c); // 简化查找 sum += value; } int remainder = sum % 43; return EncodingMap.Keys.ElementAt(remainder); // 获取余数对应的字符 } protected override int CalculateTotalWidth() { // 总宽度 = (窄条宽度 * 窄条数量) + (宽条宽度 * 宽条数量) // 注意：Code39每个字符有5条4空，其中3宽6窄。 // 起始/终止符（*） + 数据字符（含可能校验位） + 终止符（*） int charCount = Data.Length + 2 + (UseMod43Check ? 1 : 0); int narrowUnitsPerChar = 6; // 每个字符有6个窄单元（条或空） int wideUnitsPerChar = 3; // 每个字符有3个宽单元 int totalNarrowUnits = charCount * narrowUnitsPerChar; int totalWideUnits = charCount * wideUnitsPerChar; return (totalNarrowUnits * NarrowBarWidth) + (totalWideUnits * WideBarWidth); } protected override int GetBarWidth(bool isWide) => isWide ? WideBarWidth : NarrowBarWidth; protected override int GetSpaceWidth(bool isWide) => isWide ? WideBarWidth : NarrowBarWidth; } }

这里有几个关键点需要注意：

  1. 编码表：我们用'w'和'n'的字符串来表示每个字符的9个单元（5条4空）的宽窄。EncodeData方法会生成一个完整的、包含起始/终止符的条空宽窄序列。
  2. 模43校验：CalculateMod43CheckDigit方法计算校验位。它先将每个字符映射为一个数值（0-42），求和后取模43，再用余数映射回一个字符，追加到原始数据后。
  3. 宽度计算：CalculateTotalWidth方法根据字符数、每个字符的宽窄单元数以及我们设定的NarrowBarWidth和WideBarWidth来精确计算最终图片的宽度。这对于提前布局UI（比如在WPF中动态设置Image控件大小）非常有用。
  4. 大小写：在构造函数中，我们直接ToUpper()，确保数据合规。

3.3 Code 128生成器的具体实现

Code 128的实现要复杂得多，因为它涉及子集切换、校验位计算和更复杂的编码表。我们实现一个支持自动选择最优子集（B和C）的版本。

namespace BarcodeLib { public class Code128Generator : BarcodeGenerator { // Code 128字符编码表（子集B）。值表示条空模式，1=条，0=空，共11位，最后一位是校验位（这里先忽略）。 // 实际我们需要的是“模块宽度序列”，每个字符由3个条、3个空共6个单元构成，每个单元宽度1-4个模块。 // 为了简化，我们直接使用一个标准化的“模块序列”字典。这里用一个字符串表示6个单元的宽度。 // 例如：“212222” 表示：2个模块宽的条，1个模块宽的空，2个模块宽的条，2个模块宽的空，2个模块宽的条，2个模块宽的空。 private static readonly Dictionary<int, string> Code128BEncoding = new Dictionary<int, string>() { {0, "212222"}, {1, "222122"}, {2, "222221"}, {3, "121223"}, {4, "121322"}, // ... 此处应包含完整的105个字符（0-105）的编码。实际项目应从权威资料获取完整表。 // 为节省篇幅，这里仅示意。关键是要有START B (104), CODE C (99), STOP (106)的编码。 {32, "111323"}, // 空格 {33, "131123"}, // ! {48, "111233"}, // 0 {49, "111332"}, // 1 {50, "112223"}, // 2 // ... 一直到 {99, "121343"}, // CODE C {100, "121433"}, // CODE B {101, "131342"}, // CODE A {102, "131143"}, // FNC 1 {103, "131134"}, // FNC 2 {104, "113141"}, // START B (我们主要用这个) {105, "114131"}, // START C {106, "311141"}, // STOP }; private List<int> _encodedValues = new List<int>(); // 存储编码过程中选择的字符值 public Code128Generator(string data) : base(data) { } protected override bool[] EncodeData() { _encodedValues.Clear(); // 1. 选择起始符。我们实现一个简单的自动选择：如果开头有连续4个以上数字，用START C，否则用START B。 int startCode = ChooseStartCode(); _encodedValues.Add(startCode); int currentCode = startCode; // 当前子集 int i = 0; while (i < Data.Length) { if (currentCode == 105) // START C 或 处于子集C { // 子集C：一次处理两个数字 if (i + 1 < Data.Length && char.IsDigit(Data[i]) && char.IsDigit(Data[i + 1])) { int twoDigitValue = int.Parse(Data.Substring(i, 2)); _encodedValues.Add(twoDigitValue); i += 2; } else { // 遇到非数字对，需要切换回子集B _encodedValues.Add(100); // CODE B currentCode = 100; // 不增加i，继续用子集B处理当前字符 } } else // 当前是子集B (或A) { // 检查是否可以切换到更高效的子集C if (CanSwitchToC(i)) { _encodedValues.Add(99); // CODE C currentCode = 99; // 不增加i，下一轮循环将以子集C处理当前位置 } else { // 用子集B编码当前字符 int charValue = (int)Data[i]; if (charValue >= 32 && charValue <= 126) // 子集B范围 { _encodedValues.Add(charValue - 32); // 映射到编码表索引 } else { throw new ArgumentException($"Code 128子集B不支持字符 '{(char)charValue}' (ASCII {charValue})。"); } i++; } } } // 2. 计算校验位 int checksum = CalculateChecksum(_encodedValues); _encodedValues.Add(checksum); // 3. 添加终止符 _encodedValues.Add(106); // STOP // 4. 将字符值序列转换为模块宽度序列，再转换为条空bool数组 List<int> moduleSequence = new List<int>(); foreach (int value in _encodedValues) { string pattern = Code128BEncoding[value]; // 这里假设我们的编码表包含了所有值 foreach (char moduleChar in pattern) { moduleSequence.Add(int.Parse(moduleChar.ToString())); // 每个数字代表1-4个模块的宽度 } } // 5. 将模块序列转换为bool数组（true=条，false=空），交替进行 bool[] result = new bool[moduleSequence.Count]; bool isBar = true; // 第一个是条 for (int idx = 0; idx < moduleSequence.Count; idx++) { // 这里简化处理：我们用一个bool表示“当前单元是条还是空”，宽度信息存储在moduleSequence里。 // 但基类的绘图逻辑需要一个bool数组表示“是否绘制条”。我们需要重构绘图逻辑来处理可变宽度。 // 为了适配现有基类，我们这里做一个转换：将每个模块宽度展开。 // 例如，模块宽度“2”的条，展开为两个连续的true。 // 这需要修改基类的GenerateImage方法。更清晰的做法是让EncodeData返回一个“宽度值”数组。 // 由于篇幅，我们采用简化版：假设所有单元宽度相等（NarrowBarWidth）。 // 实际项目中，应实现一个更复杂的“ModuleWidthGenerator”。 } // 简化返回 return new bool[] { true, false }; // 占位 } private int ChooseStartCode() { // 简单策略：检查前4个字符是否都是数字 if (Data.Length >= 4 && Data.Take(4).All(char.IsDigit)) return 105; // START C return 104; // START B } private bool CanSwitchToC(int position) { // 从当前位置开始，是否有连续4个或以上数字 int digitCount = 0; for (int j = position; j < Data.Length && digitCount < 4; j++) { if (char.IsDigit(Data[j])) digitCount++; else break; } return digitCount >= 4; } private int CalculateChecksum(List<int> values) { // 校验和计算: (StartCode值 + 每位值 * 位置权重) mod 103 // 位置权重从1开始 int sum = values[0]; // 起始字符值 for (int i = 1; i < values.Count; i++) { sum += (values[i] * i); } return sum % 103; } protected override int CalculateTotalWidth() { // 简化计算：每个字符由11个模块构成（6个单元）。 // 总模块数 = (字符数) * 11 // 假设我们1个模块 = NarrowBarWidth像素 int charCount = _encodedValues.Count + 2; // 数据字符+校验位+终止符 int modulesPerChar = 11; return charCount * modulesPerChar * NarrowBarWidth; } protected override int GetBarWidth(bool isWide) => NarrowBarWidth; // Code128宽窄比固定，这里简化 protected override int GetSpaceWidth(bool isWide) => NarrowBarWidth; } }

重要提示：上面的Code 128实现是高度简化的原理性演示。一个生产可用的Code 128编码器需要完整的编码表（105个字符），并且绘图逻辑需要处理每个单元1-4模块的可变宽度。在实际开发中，我强烈建议你寻找一个经过验证的开源库（如BarcodeLib）或者从官方标准文档中获取准确的编码表。这里的代码旨在帮你理解其核心流程：选择起始符 -> 遍历数据并动态切换子集 -> 计算校验和 -> 组装完整编码序列。

4. 实战集成与图像输出：在WPF、WinForms及打印中的运用

有了生成Bitmap的核心类，集成到各种应用中就非常容易了。

4.1 在WPF应用程序中使用

WPF的Image控件默认使用BitmapImage，我们需要将System.Drawing.Bitmap转换一下。

// 在WPF的ViewModel或代码后台中 using System.IO; using System.Windows.Media.Imaging; public BitmapImage GenerateBarcodeImageForWpf(string data, bool isCode128 = true) { BarcodeGenerator generator; if (isCode128) { generator = new Code128Generator(data) { Height = 60, NarrowBarWidth = 2 }; } else { generator = new Code39Generator(data) { Height = 60, NarrowBarWidth = 2, WideBarWidth = 4 }; } using (Bitmap bmp = generator.GenerateImage()) { using (MemoryStream ms = new MemoryStream()) { bmp.Save(ms, System.Drawing.Imaging.ImageFormat.Png); ms.Position = 0; BitmapImage bitmapImage = new BitmapImage(); bitmapImage.BeginInit(); bitmapImage.CacheOption = BitmapCacheOption.OnLoad; bitmapImage.StreamSource = ms; bitmapImage.EndInit(); bitmapImage.Freeze(); // 跨线程使用时建议Freeze return bitmapImage; } } } // 在XAML中 <Image x:Name="BarcodeImage" Width="Auto" Height="Auto" Stretch="Uniform"/> // 在代码中赋值 BarcodeImage.Source = GenerateBarcodeImageForWpf("TEST-12345");

4.2 在WinForms应用程序中使用

WinForms更直接，因为PictureBox本身就支持System.Drawing.Bitmap。

private void GenerateAndDisplayBarcode() { var generator = new Code39Generator("ABC-123") { Height = 80 }; pictureBox1.Image = generator.GenerateImage(); // 如果需要保存 generator.GenerateImage().Save(@"C:\barcode.png", System.Drawing.Imaging.ImageFormat.Png); }

4.3 直接打印到标签打印机

这是工业场景中最常见的需求。我们通常不生成图片文件再打印，而是直接通过Graphics对象绘制到打印机的PrintPage事件中。

private void PrintBarcodeLabel(object sender, PrintPageEventArgs e) { var generator = new Code128Generator("P20240822001") { Height = 120, NarrowBarWidth = 3, IncludeText = true }; // 1. 生成条码Bitmap（用于计算尺寸或直接绘制） using (Bitmap barcodeBmp = generator.GenerateImage()) { // 2. 定义标签左上角起点 int startX = 50; int startY = 50; // 3. 直接绘制Bitmap到打印页面 e.Graphics.DrawImage(barcodeBmp, startX, startY); // 4. 或者，你也可以直接使用生成器的逻辑在Graphics上画，避免中间Bitmap // 这里演示直接画Bitmap，简单可靠。 } // 5. 绘制其他信息（如物料名称、日期） using (Font font = new Font("微软雅黑", 12)) using (Brush brush = Brushes.Black) { e.Graphics.DrawString("物料：电阻 10KΩ", font, brush, 50, 200); e.Graphics.DrawString($"日期：{DateTime.Now:yyyy-MM-dd}", font, brush, 50, 230); } e.HasMorePages = false; // 只有一页 } // 触发打印 private void btnPrint_Click(object sender, EventArgs e) { PrintDocument pd = new PrintDocument(); pd.PrintPage += PrintBarcodeLabel; // 配置打印机（如选择特定的标签打印机） pd.PrinterSettings.PrinterName = "Your_Label_Printer_Name"; try { pd.Print(); } catch (Exception ex) { MessageBox.Show($"打印失败: {ex.Message}"); } }

打印避坑经验：

  1. DPI问题：打印机Graphics的DPI和屏幕不同。如果你用DrawImage，图片可能会被拉伸。最好是根据打印机的DPI，在生成Bitmap时就用更高的分辨率，或者直接用Graphics的绘图方法（如FillRectangle）在打印事件里重绘条码，这样最精确。
  2. 内存释放：PrintPage事件可能被频繁调用。确保所有Font,Brush,Bitmap对象都在using语句中或手动Dispose，否则在大量打印时会导致内存泄漏（GDI+对象泄漏）。
  3. 打印机驱动：有些老式的斑马（Zebra）等工业打印机，可能更倾向于接收原始的ZPL指令。对于这种场景，你需要将条码编码成ZPL命令字符串发送，而不是传图片。这需要另一套实现，但核心的编码算法（生成条空序列）是通用的。

5. 性能优化、常见问题与调试技巧

当你在一个需要批量生成成百上千个条码的后台服务里使用这些代码时，性能就变得很重要。

5.1 性能优化要点

  • 对象复用：Graphics,SolidBrush,Font这些GDI+对象创建和销毁成本高。在批量生成时，可以考虑在循环外创建一次，并重复使用（但要注意线程安全，每个线程用自己的对象）。
  • Bitmap尺寸预计算：CalculateTotalWidth方法非常关键。提前知道图片尺寸，可以一次性分配好Bitmap内存，避免在绘图过程中反复调整。
  • 避免不必要的文本渲染：如果不需要底部可读文本，务必设置IncludeText = false，可以节省测量和绘制文本的开销。
  • 考虑使用LockBits进行像素级操作：对于极致的性能要求，可以使用Bitmap.LockBits方法直接操作内存中的像素数据来绘制条码，这比通过Graphics绘图快一个数量级。但这会大大增加代码复杂度，除非每秒生成数千个条码，否则用Graphics足够了。

5.2 扫描枪读不出或读错？排查清单

这是上线后最常遇到的问题，多半不是代码逻辑问题，而是物理或参数问题。

  1. 条码尺寸（密度）不合适：NarrowBarWidth设置得太小。热敏打印机精度有限，如果窄条宽度小于2个像素，打印出来可能糊成一团，扫描枪无法分辨。经验值：对于300 DPI的标签打印机，NarrowBarWidth设置为3或4比较保险。可以先在屏幕上放大显示，确保条空清晰可辨。
  2. 宽窄比错误：Code 39的宽窄比通常是2:1或3:1。确保WideBarWidth是NarrowBarWidth的整数倍。Code 128的宽窄比是固定的（1:1:2:3等，取决于编码），我们的简化实现用了固定宽度，生产代码必须实现可变模块宽度。
  3. 静区（Quiet Zone）不足：条码左右两侧必须留出足够的空白区域（静区），否则扫描枪无法定位起始符。静区宽度通常不小于10倍窄条宽度。在我们的绘图逻辑中，生成的图片是紧贴条码内容的，你需要在使用时，在Image控件或打印布局的左右预留空白。
  4. 颜色对比度不足：条码必须是深色条、浅色空。不要用红色条（某些激光扫描枪对红色不敏感）、不要用反光材料。最简单的就是黑条白底。
  5. 校验位问题：确保扫描枪的校验设置与你的条码一致。如果你用了Code 39 with Mod 43，扫描枪也需要开启相应的校验功能，否则它会尝试自己计算校验位，导致不匹配。Code 128的校验是强制的，一般没问题。
  6. 打印质量：打印机喷头堵塞、碳带用完、打印温度不对、标签纸质量差，都会导致条码印刷不清。拿手机摄像头（打开微信扫码）先扫一下屏幕上的条码图片，如果能识别，再打印出来扫。如果屏幕能扫，打印出来不能扫，问题就在打印机或标签纸上。

5.3 调试与验证技巧

  • 单元测试验证编码：为EncodeData方法编写单元测试，用已知的条码生成器（如在线工具）生成的条码图片作为基准，对比你生成的条码图片的像素宽度序列是否一致。
  • 可视化调试：在开发时，可以将生成的bool[]编码序列打印到控制台，用#表示条，空格表示空，直观地检查模式是否正确。
  • 使用验证器：有一些开源库或在线服务可以验证条码的合规性（如是否符合ANSI/AIM标准）。对于关键应用，这是一个不错的验收步骤。

最后，虽然我们从头实现了一遍，但对于绝大多数商业项目，我建议在NuGet上搜索并评估成熟的条码生成库，比如ZXing.Net、BarcodeLib。它们经过了广泛测试，支持更多码制（QR Code, PDF417等），性能也更优。自己实现的核心价值在于理解原理、应对特殊定制需求以及在无法引入第三方依赖的极端环境下（比如某些高度受限的工控环境）能够自主可控。希望这篇近万字的梳理，能帮你彻底搞定C#中的条码生成，下次再遇到“拒绝访问”或者网络不通时，你就能从容地掏出这套本地生成的方案了。