C#实战：TSC打印机条码与二维码打印的完整实现指南

1. 从零开始：为什么选择C#和TSC打印机？

如果你正在开发一个仓库管理系统、一个零售收银软件，或者任何需要打印产品标签、物流面单的应用，那么你很可能已经和条码、二维码打印机打过交道了。在众多品牌和型号中，TSC（台半）打印机以其稳定、性价比高和开发友好，在工业、商业领域有着广泛的应用。而C#，作为.NET生态的主力语言，在企业级应用开发中更是占据着举足轻重的地位。当C#遇上TSC打印机，就形成了一套非常经典且高效的标签打印解决方案。

我接手过不少从老旧VB、Delphi甚至更早系统迁移过来的项目，很多都涉及到TSC打印机的集成。一开始我也觉得头大，官方文档看起来参数繁多，网上的资料又零零碎碎。但真正上手后你会发现，它的核心逻辑非常清晰：通过一个叫做TSCLIB.dll的动态链接库，用近乎“发指令”的方式告诉打印机该做什么。这就像你给一个熟练的工人下达一系列精确的步骤，他就能完美地生产出你想要的标签。

所以，这篇文章的目的，就是把我这些年踩过的坑、总结的经验，用最直白的方式分享给你。无论你是第一次接触硬件打印的新手，还是正在为旧系统改造而头疼的开发者，我都会带你走完从环境搭建、DLL引用、模板设计到最终打印的完整流程。我们不谈空泛的理论，只讲能直接复制粘贴、跑通代码的实战操作。相信我，跟着步骤走，你很快就能让打印机“听话”地吐出你设计的标签。

2. 战前准备：搭建你的开发与测试环境

在开始写代码之前，把“战场”布置好至关重要。这里没有复杂的服务器集群，但几个关键步骤错了，后面就会步步维艰。

2.1 获取核心武器：TSCLIB.DLL与驱动

首先，你需要两个核心文件：TSCLIB.dll和打印机驱动。很多新手会直接在网上搜索下载DLL，但这其实有风险，版本不对或来源不明可能导致各种诡异问题。最稳妥的方式是从你打印机的配套光盘里找，或者去TSC官方网站，根据你的具体打印机型号（比如TTP-244 Pro、MH240）下载对应的“Utility”工具包，这个工具包里通常就包含了我们需要的DLL和驱动。

拿到TSCLIB.dll后，我建议你不要直接把它扔到系统目录。更好的做法是，在你的C#项目目录下，比如创建一个Libs或Dependencies的文件夹，把它放进去。这样做的好处是项目路径清晰，便于团队协作和后期部署。驱动安装就更简单了，通常是一路“下一步”，安装完成后，在Windows的“设备和打印机”里应该就能看到你的TSC打印机了。记下它的确切名称，比如“TSC TTP-244 Pro (Copy 1)”，后面代码里会用到。

2.2 创建项目与引用DLL

打开你的Visual Studio（我用的是VS2022，2019或2017也完全没问题），创建一个新的C#项目，控制台应用、WinForms、WPF甚至ASP.NET Core（需要本地打印）都可以，根据你的实际应用场景来定。

关键的一步来了：如何让C#项目认识这个非托管（Unmanaged）的TSCLIB.dll？我们不是通过“添加引用”那种方式来引用.NET程序集，而是使用DllImport特性进行动态调用。这意味着，你只需要确保这个DLL文件在程序运行时能够被找到即可。为了方便，我们可以把它复制到项目的输出目录（如bin\Debug）。可以在VS中设置：右键DLL文件 -> 属性 -> 复制到输出目录，选择“如果较新则复制”。

现在，创建一个核心的助手类，比如就叫TscPrinterHelper.cs。这个类将是我们所有打印操作的总指挥部。在类的最开始，我们就需要把要用到的DLL函数全部“声明”出来。这个过程虽然看起来是一长串代码，但其实就像是在C#里给那些DLL里的函数起个“外号”，告诉编译器：“等下我调用这个‘外号’的时候，你去DLL里找对应的真实函数执行。”

using System.Runtime.InteropServices;

public class TscPrinterHelper
{
    // 1. 打开打印机端口
    [DllImport("TSCLIB.dll", EntryPoint = "openport")]
    public static extern int openport(string printername);

    // 2. 设置标签基本参数（宽度、高度、速度等）
    [DllImport("TSCLIB.dll", EntryPoint = "setup")]
    public static extern int setup(string width, string height, string speed,
                                   string density, string sensor, string vertical, string offset);

    // 3. 清除打印机缓冲区（每次打印新标签前必须调用）
    [DllImport("TSCLIB.dll", EntryPoint = "clearbuffer")]
    public static extern int clearbuffer();

    // 4. 打印条码