1. 项目概述：为什么条形码生成是.NET开发者的必备技能

在零售、仓储、物流甚至办公自动化领域，条形码无处不在。作为一名有多年一线开发经验的工程师，我处理过太多需要集成条码功能的项目了。从简单的产品标签打印到复杂的仓库管理系统（WMS），条码都是实现数据快速、准确采集的基石。很多新手开发者可能会觉得，生成条码不就是调用一个第三方库的事情吗？但实际踩过坑才知道，从编码规则、校验和计算，到图形渲染精度、打印适配，每一个环节都藏着细节。

这次我们聚焦于两种最经典、应用最广泛的条形码制式：Code 39和Code 128。在C# .NET环境下，我将带你从零开始，不依赖任何重量级商业组件，深入原理并实现一个轻量、可控的条形码生成器。你会发现，自己动手实现不仅能让你对条码规范有透彻理解，更能让你在遇到定制化需求（如特殊尺寸、嵌入LOGO、复杂排版）时游刃有余，彻底摆脱对黑盒组件的依赖。

2. 核心原理与标准解析：读懂条码的语言

在动手写代码之前，我们必须先理解条码在“说”什么。条码本质上是一种将数字/字母信息转换为黑白条纹宽窄序列的图形编码。不同的条纹排列规则，就是不同的条码制式。

2.1 Code 39：简单可靠的“老将”

Code 39（又称3 of 9 code）因其编码字符集中包含0-9、A-Z以及几个特殊符号（-， .， $， /， +， %）和空格共43个字符而得名。它的特点是编码简单，具有自校验特性，但密度较低。

编码原理：每个Code 39字符由9个元素（5条黑条+4条白条）构成，其中3个是宽元素（用二进制1表示），6个是窄元素（用二进制0表示），这就是“3 of 9”的由来。例如，字符‘A’的编码序列是“窄黑条、宽白条、窄黑条、窄白条、宽黑条、窄白条、窄黑条、窄白条、宽黑条”。我们需要一个将字符映射到这种“宽窄”模式的字典。

起始/终止符：每个Code 39条码都以一个特殊的星号（*）字符作为开始和结束标志。这个星号不包含在要编码的数据中，是物理条码的一部分。

校验和（可选）：标准Code 39没有强制校验位。但为了更高的数据可靠性，可以使用“Code 39 Extended”或“Mod 43”校验。Mod 43校验的计算方法是：将每个字符对应的值（0-42）相加，然后对43取模，最后将得到的余数对应的字符作为校验位附加在数据末尾。这个功能我们会在实现时作为可选项提供。

2.2 Code 128：高密度、多字符集的“多面手”

Code 128是目前使用最广泛的线性条码之一，尤其在物流和包装行业。它的优势非常明显：密度高、支持全部128个ASCII字符、并且拥有强大的自动编码优化能力。

字符集与切换：Code 128定义了三个子集（Code Set A, B, C），它们共享相同的条空图案，但代表的字符意义不同。

• Code 128A：支持数字、大写字母、控制字符（如换行、回车）。
• Code 128B：支持数字、大小写字母、常用符号。
• Code 128C：高效的数字编码模式。它将两个数字编码为一个字符，使得数字数据的密度极高。例如，“123456”在Code 128C中仅用3个条码字符表示。

编码原理：每个Code 128字符由11个模块（黑条或白条）构成，包含3个条和3个空，其宽度组合符合特定的“3黑条+3白条，总宽度为11模块”的规则。每个字符都有一个对应的数值（0-105）和三个不同的“条空宽度模式”（分别对应A、B、C子集，但图案相同，含义不同）。

起始符与校验和：编码必须以一个代表所用字符集（A, B, 或 C）的起始字符开始。Code 128使用模103校验。校验位的计算方式是：从起始字符的值开始，将每个字符的值乘以其在数据流中的位置（起始符位置为1），求和，然后对103取模。这个校验位是强制性的，会自动添加到条码数据中。

自动编码优化：一个优秀的Code 128生成器应该能分析输入数据，智能地在A、B、C三个子集间切换，以生成最短的条码。例如，连续的数字段应切换到Code 128C，遇到小写字母时切换到Code 128B。这是我们实现时的重点和难点。

注意：很多初学者容易混淆“要编码的原始数据”和“最终条码图形所代表的完整数据流”。对于Code 39，完整数据流是*+原始数据+*。对于Code 128，完整数据流是起始符+（可能包含切换字符的）编码数据+校验符+终止符。图形渲染的是这个完整数据流。

3. 项目设计与核心类规划

理解了原理，我们就可以开始设计代码结构了。我们的目标是构建一个清晰、可扩展的类库，核心是抽象出条码生成的通用流程，然后为Code 39和Code 128提供具体实现。

3.1 总体架构设计

我倾向于采用策略模式（Strategy Pattern）与模板方法模式（Template Method）的结合。定义一个抽象的BarcodeGenerator基类，它规定了生成条码的固定步骤（如数据验证、编码转换、计算校验和、生成图形），而将编码逻辑的具体实现交给子类。

// 抽象基类，定义生成条码的骨架算法 public abstract class BarcodeGenerator { public abstract string SymbologyName { get; } // 模板方法：生成条码的固定流程 public Bitmap GenerateBarcodeImage(string data, int height, int quietZone) { // 1. 验证输入数据 if (!ValidateData(data)) throw new ArgumentException($"Invalid data for {SymbologyName}"); // 2. 将数据编码为内部表示（宽窄模块序列） string encodedSequence = EncodeData(data); // 3. 计算校验和（如果适用）并整合到编码序列 encodedSequence = AppendChecksumIfNeeded(encodedSequence); // 4. 添加起始/终止符 encodedSequence = AddStartStopCharacters(encodedSequence); // 5. 将模块序列转换为黑白条带数组 bool[] bars = ConvertSequenceToBars(encodedSequence); // 6. 渲染为Bitmap图像 return RenderToBitmap(bars, height, quietZone); } // 以下为需要子类实现的抽象方法 protected abstract bool ValidateData(string data); protected abstract string EncodeData(string data); protected abstract string AppendChecksumIfNeeded(string sequence); protected abstract string AddStartStopCharacters(string sequence); protected abstract bool[] ConvertSequenceToBars(string encodedSequence); // 渲染为位图的方法可以在基类中提供通用实现 protected virtual Bitmap RenderToBitmap(bool[] bars, int height, int quietZone) { // 通用渲染逻辑，计算宽度、创建画布、绘制条空 // ... } }

3.2 Code39Generator 类设计要点

对于Code 39，我们需要：

1. 字符映射表：一个Dictionary<char, string>，将43个有效字符映射到其“宽窄”模式字符串，例如'A' => "100001001"（这里1代表宽，0代表窄，顺序是黑条、白条交替）。
2. 编码方法：遍历输入字符串，从映射表中查找每个字符的模式并拼接。
3. 校验和计算：实现可选的Mod 43校验。
4. 起始/终止符：在编码序列的首尾添加星号（*）的编码模式。

一个关键细节：在ConvertSequenceToBars方法中，我们需要将“100001001”这样的字符串，转换为[true, false, true, false, false, false, true, false, true]这样的布尔数组，其中true表示一个模块宽度的黑条，false表示一个模块宽度的白条。注意，一个字符的9个元素（5黑4白）是连续绘制的，字符间通常由一个窄白条（分隔符）隔开，但这个分隔符通常已经包含在编码规则里（每个字符编码的最后一个元素是黑条，下一个字符的第一个元素也是黑条，中间自然需要一个白条分隔）。更简单的做法是，我们的编码字符串直接包含所有条和空的信息。

3.3 Code128Generator 类设计要点

Code 128的实现要复杂得多，是本次项目的核心挑战。

1. 编码表：我们需要一个包含105个条码字符定义的完整表。每个定义包括：该字符在A/B/C子集中的含义、对应的数值、以及一个长度为11的整数数组（表示6个条/空的模块宽度，例如[2,1,2,3,2,2]表示：2个模块宽的黑条，1个模块宽的白条，2个模块宽的黑条...）。
2. 自动编码优化：这是算法的精髓。我们需要一个状态机来遍历输入字符串，决定何时切换字符集以得到最短编码。一个经典的算法是：
   • 从Code 128B开始（因为它支持最全的字符）。
   • 扫描字符串，如果遇到连续4位或更多数字，则考虑切换到Code 128C。
   • 计算如果切换，能节省多少字符。切换本身需要消耗一个切换字符（如从B切换到C的CodeC字符），所以只有当节省的字符数大于切换成本时才执行切换。
   • 还需要处理控制字符（如FNC1）等特殊情况。
3. 校验和计算：在生成完整的数据字符序列（包括起始符、数据字符、切换符）后，按照模103规则计算校验字符，并追加到序列末尾。
4. 终止符：最后添加一个特殊的终止字符，它的条空模式是固定的（[2,3,3,1,1,2]），并且不参与校验和计算，但它是条码图形的必要组成部分。

实操心得：实现Code 128的自动优化时，不要追求一次扫描就达到全局最优，那会非常复杂。一个在实践中足够好且稳定的策略是“贪婪算法”：在当前位置，根据接下来的几个字符，选择当前最优的字符集。虽然可能不是理论上的最短编码，但结果已经非常高效，且代码可维护性强。

4. 核心实现与代码详解

接下来，我们深入到具体代码。由于篇幅限制，我将展示最关键的几个方法，并解释其中的设计决策和易错点。

4.1 Code 39 的编码与渲染实现

首先，我们初始化Code 39的字符映射。这里用一个字符串表示“宽窄”模式，N代表窄，W代表宽。顺序是：黑条、白条、黑条、白条... 共9个元素。

public class Code39Generator : BarcodeGenerator { public override string SymbologyName => "CODE39"; 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', "NNWNNWNNW"}, {'C', "WNWNNWNNN"}, // ... 此处省略B-Z的映射 {'*', "NNNWNNWWN"} // 起始/终止符 }; protected override bool ValidateData(string data) { if (string.IsNullOrEmpty(data)) return false; foreach (char c in data) { if (!_encodingMap.ContainsKey(c)) return false; } return true; } protected override string EncodeData(string data) { var encodedBuilder = new StringBuilder(); foreach (char c in data) { encodedBuilder.Append(_encodingMap[c]); } return encodedBuilder.ToString(); } protected override string AppendChecksumIfNeeded(string sequence) { // 如果用户启用了Mod43校验，在此处计算并追加 // 计算逻辑：将每个字符对应的值相加，对43取模，找到对应字符 // 这里为了简化，假设有一个UseChecksum属性和CalculateMod43Checksum方法 if (UseMod43Checksum) { int sum = 0; foreach (char c in _originalData) // _originalData 需在EncodeData前保存 { sum += GetCharValue(c); // 获取字符的数值(0-42) } int checksumValue = sum % 43; char checksumChar = _encodingMap.Keys.ElementAt(checksumValue); // 根据值找到字符 // 将校验字符的编码追加到序列 sequence += _encodingMap[checksumChar]; } return sequence; } protected override string AddStartStopCharacters(string sequence) { // 对于Code39，起始和终止符都是'*'，我们在编码数据前后加上它的编码 return _encodingMap['*'] + sequence + _encodingMap['*']; } protected override bool[] ConvertSequenceToBars(string encodedSequence) { // encodedSequence 现在是类似 "NNNWWNWNNWNNWNNNNW..." 的字符串 List<bool> bars = new List<bool>(); bool isBar = true; // 从黑条开始 foreach (char widthCode in encodedSequence) { bool isWide = (widthCode == 'W'); // 根据当前是条还是空，以及宽窄，添加对应数量的模块 // 窄模块 = 1个单元，宽模块通常 = 2.5或3个单元（比例可配置） int moduleWidth = isWide ? _wideMultiplier : 1; for (int i = 0; i < moduleWidth; i++) { bars.Add(isBar); // true 代表黑，false代表白 } isBar = !isBar; // 切换条/空 } return bars.ToArray(); } }

关键参数说明：

• _wideMultiplier：宽条/空与窄条/空的宽度比例。Code 39规范建议宽窄比在2:1到3:1之间，常用2.5或3。这个值直接影响条码的可读性和尺寸。比例太小，扫描器不易区分；比例太大，条码会过长。

4.2 Code 128 的自动编码与实现

Code 128的实现是重头戏。我们先定义条码字符的结构和初始化编码表。

public class Code128Generator : BarcodeGenerator { public override string SymbologyName => "CODE128"; private class Code128Symbol { public int Value { get; set; } // 该图案对应的数值 public string Pattern { get; set; } // 长度为6的字符串，如"212322"，表示条空宽度序列 public char? AsciiA { get; set; } // 在A子集中的含义 public char? AsciiB { get; set; } // 在B子集中的含义 public Func<string, int>? AsciiC { get; set; } // 在C子集中的含义，是两位数字 } private static List<Code128Symbol> _symbols; // 完整的105个符号表（初始化略） // 自动编码的核心方法 private List<int> EncodeWithAutoSelection(string data) { List<int> encodedValues = new List<int>(); int currentSet = 104; // 默认起始符B (CODE_B = 104) encodedValues.Add(currentSet); int i = 0; while (i < data.Length) { // 检查是否可以且应该切换到CODE C if (i < data.Length - 3 && char.IsDigit(data[i]) && char.IsDigit(data[i+1])) { // 找到连续数字段的长度 int digitCount = 0; while (i + digitCount < data.Length && char.IsDigit(data[i + digitCount])) digitCount++; // 如果连续数字是偶数个，且长度>=4，切换到CODE C更高效 if (digitCount >= 4 && digitCount % 2 == 0) { if (currentSet != 105) // 如果当前不是CODE C { encodedValues.Add(99); // CODE C切换字符 currentSet = 105; } // 每两个数字编码为一个CODE C字符 for (int d = 0; d < digitCount; d += 2) { int twoDigits = int.Parse(data.Substring(i + d, 2)); encodedValues.Add(twoDigits); } i += digitCount; continue; } } // 默认处理：按当前字符集（这里简化，假设一直用B集）编码一个字符 char currentChar = data[i]; var symbol = _symbols.FirstOrDefault(s => s.AsciiB == currentChar); if (symbol != null) { encodedValues.Add(symbol.Value); } else { throw new ArgumentException($"Unsupported character: {currentChar}"); } i++; } return encodedValues; } protected override string EncodeData(string data) { List<int> valueSequence = EncodeWithAutoSelection(data); // 计算校验和 int checksum = valueSequence[0]; // 起始符值 for (int idx = 1; idx < valueSequence.Count; idx++) { checksum += valueSequence[idx] * idx; } checksum = checksum % 103; valueSequence.Add(checksum); // 追加校验字符值 valueSequence.Add(106); // 追加终止符值（固定） // 现在将这一系列数值转换为条空模式字符串 StringBuilder patternBuilder = new StringBuilder(); foreach (int val in valueSequence) { var symbol = _symbols[val]; // 假设_symbols列表索引等于值 patternBuilder.Append(symbol.Pattern); } return patternBuilder.ToString(); // 返回如"211214231113..."的字符串 } protected override bool[] ConvertSequenceToBars(string encodedSequence) { // encodedSequence 现在是类似 "211214..."的字符串，每个数字代表1个模块的宽度 List<bool> modules = new List<bool>(); bool isBar = true; foreach (char ch in encodedSequence) { int width = ch - '0'; // 将字符'2'转换为数字2 for (int i = 0; i < width; i++) { modules.Add(isBar); } isBar = !isBar; } return modules.ToArray(); } // 其他抽象方法实现（ValidateData, AppendChecksumIfNeeded等）略 }

注意事项：上面的自动编码算法是一个高度简化的版本，仅演示了切换到CODE C的逻辑。完整的实现还需要处理从C切回B或A、处理FNC功能字符、以及处理奇数个连续数字（最后一个数字需用CODE B编码）等边界情况。在实际项目中，建议参考成熟的算法或使用经过测试的库作为基础。

4.3 通用图形渲染方法

无论是Code 39还是Code 128，最终都要将布尔数组（模块序列）渲染成位图。这是BarcodeGenerator基类中RenderToBitmap方法的通用实现。

protected virtual Bitmap RenderToBitmap(bool[] bars, int height, int quietZone) { // 1. 计算图像宽度 int moduleWidth = 2; // 每个模块的像素宽度（可配置，影响条码密度） int totalModules = bars.Length; int quietZonePixels = quietZone * moduleWidth; // 静区宽度 int imageWidth = totalModules * moduleWidth + 2 * quietZonePixels; // 2. 创建位图 Bitmap bmp = new Bitmap(imageWidth, height, PixelFormat.Format32bppArgb); using (Graphics g = Graphics.FromImage(bmp)) { g.Clear(Color.White); // 白色背景 g.InterpolationMode = System.Drawing.Drawing2D.InterpolationMode.NearestNeighbor; g.PixelOffsetMode = System.Drawing.Drawing2D.PixelOffsetMode.Half; // 3. 绘制静区（左右留白） // 静区是必须的，否则扫描器无法识别起始和结束。 // 4. 绘制条码主体 int x = quietZonePixels; for (int i = 0; i < bars.Length; i++) { using (SolidBrush brush = new SolidBrush(bars[i] ? Color.Black : Color.White)) { g.FillRectangle(brush, x, 0, moduleWidth, height); } x += moduleWidth; } // 5. （可选）在底部绘制可读文本（Human Readable Text） if (!string.IsNullOrEmpty(_originalData)) { using (Font font = new Font("Arial", 10)) using (StringFormat sf = new StringFormat() { Alignment = StringAlignment.Center }) { // 文本绘制在条码下方，居中 RectangleF textRect = new RectangleF(quietZonePixels, height - 20, totalModules * moduleWidth, 20); g.DrawString(_originalData, font, Brushes.Black, textRect, sf); } } } return bmp; }

关键参数与技巧：

• moduleWidth：这是控制条码“密度”和打印精度的关键。moduleWidth=2表示每个最小模块（窄条）宽2像素。对于高分辨率打印，可以设为1；对于屏幕显示或低精度打印，可能需要设为3或4以确保扫描可靠性。
• quietZone：静区是条码左右两侧的空白区域，绝对不可或缺。国际标准规定静区宽度应不小于10倍模块宽度。我们这里用quietZone参数表示静区包含的模块数，通常设为10。
• 抗锯齿：绘制条码时，必须关闭抗锯齿（Graphics.SmoothingMode和TextRenderingHint使用默认值即可）。抗锯齿会产生灰色边缘，严重干扰扫描器识别。
• 颜色：必须是高对比度，通常是黑条白底。也可以使用深蓝、深绿等深色条，但必须保证与背景有足够的对比度。

5. 高级应用、优化与问题排查

一个基础的生成器完成后，我们需要考虑如何让它更健壮、更实用。

5.1 支持多种输出格式与分辨率

除了返回Bitmap，我们还可以轻松扩展，支持保存为文件或内存流。

public void SaveToFile(string data, string filePath, ImageFormat format, int dpi = 300) { using (Bitmap bmp = GenerateBarcodeImage(data, height: 100, quietZone: 10)) { // 设置DPI，这对打印至关重要 bmp.SetResolution(dpi, dpi); bmp.Save(filePath, format); // 支持PNG, JPEG, BMP, TIFF等 } } public byte[] SaveToPngByteArray(string data) { using (Bitmap bmp = GenerateBarcodeImage(data, height: 100, quietZone: 10)) using (MemoryStream ms = new MemoryStream()) { bmp.Save(ms, ImageFormat.Png); return ms.ToArray(); } }

DPI设置的重要性：如果你生成的条码用于打印，尤其是贴标或包装，必须正确设置DPI。例如，你希望条码的物理宽度是5厘米，每个模块宽度是0.25毫米。如果DPI是300（每英寸300点），那么每毫米约11.8像素。你需要精确计算moduleWidth的像素值来匹配物理尺寸。一个常见的做法是，先确定物理尺寸和DPI，再反推像素尺寸。

5.2 性能优化与内存管理

在批量生成条码（如生成上万张物流面单）时，性能至关重要。

• 对象复用：避免在循环中频繁创建Graphics,Font,Brush对象。可以使用对象池或using语句确保及时释放。
• Bitmap释放：调用GenerateBarcodeImage方法获取的Bitmap，调用方必须负责Dispose()，否则会导致内存泄漏。可以考虑返回Image或提供using包装。
• 并行处理：如果生成过程是CPU密集型的（如复杂的Code 128自动编码），且批量任务独立，可以使用Parallel.ForEach进行并行生成，显著提升速度。

5.3 常见问题与排查技巧实录

在实际使用中，你可能会遇到条码扫描器无法识别的各种问题。下面是一个快速排查清单：

一个实用的调试技巧：实现一个GetEncodedHumanReadableString方法，输出内部的编码序列。例如，对于Code 39，输出类似*12345AB*的字符串；对于Code 128，输出类似[START_B] 12 34 [CODE_C] 56 78 [CHECKSUM] [STOP]的序列。将这个字符串与标准编码表或在线生成器结果对比，能快速定位编码逻辑错误。

最后，我个人在多年项目中的体会是，自己实现条码生成的核心价值在于“可控”和“理解”。当出现打印模糊、扫描率低等疑难杂症时，你能深入到每一个模块的宽度、每一个静区的像素去排查，这是使用封闭第三方组件无法比拟的优势。对于绝大多数应用，从成熟的开源库（如ZXing.Net）开始是更高效的选择；但当你有极端定制化需求，或需要将条码技术深度集成到你的核心业务逻辑中时，亲手打造这套工具链的经历将是无价的。