Search In: Doc:文档： Altium Designer
Altium DesignerAltium 365Altium MCAD CoDesignerAltium On-Prem Enterprise ServerCompany DashboardAltium Developer Center
Product 关闭
搜索 搜索文档

使用文本对象

Updated: 十月 05, 2026

概览

本文介绍如何在 Altium Designer 的 PCB 文档和 PCB 封装中放置文本对象、设置其格式并进行编辑，涵盖单行字符串、多行文本框，以及条形码和二维码等选项。文章还将说明特殊字符串的工作原理、取值来源、显示方式，以及如何使用它们在 PCB 或生成的输出文件中直接显示电路板、项目、系统和参数信息。如果您希望通过实用指南，更充分地利用电路板和文档中的文本，请继续阅读。本文将帮助您熟练使用这些功能。

- 了解如何放置和编辑文本对象，在字符串模式与文本框模式之间切换，以及使用键盘快捷键进行旋转、镜像、翻转和切换层。
- 理解什么是特殊字符串、如何添加特殊字符串，以及如何用它们显示 PCB、项目、变体、元件和系统信息。
- 了解如何利用文本对象的自动换行文本框、条形码和二维码功能，满足文档编制与制造需求。
使用 AI 深入了解：

文本对象可在所选层上放置单行字符串或多行文本框，并支持多种显示样式和格式 ，包括常用的条形码标准和二维码。文本可以是用户自定义文本，也可以是一种称为“特殊字符串”的特殊类型字符串 ，用于在电路板上显示电路板或系统信息 ，或用户参数的值。 文本框是一个可调整大小的矩形区域，可容纳多行文本，并可自动换行和裁剪文本，使其保持在文本框边界内。

已放置的文本对象
已放置的文本对象

在 PCB 编辑器和 PCB 封装编辑器中，均可通过主菜单中的 Place » String 或 Place » Text Frame 命令放置文本对象。启动字符串放置命令后，光标将变为十字光标，并进入文本放置模式。一个文本对象将浮动在光标上：

  1. 定位光标，然后单击或按 Enter 放置文本对象。
  2. 继续放置其他文本对象，或右键单击或按 Esc 退出放置模式。
根据所选的放置命令（Place » String 或 Place » Text Frame），正在放置的文本对象将处于 String 或 Frame 模式，可在放置过程中或放置后，通过 Properties 面板更改此模式。

放置过程中还可执行以下操作：

  • 按 Spacebar 逆时针旋转文本对象，或按 Shift+Spacebar 顺时针旋转。旋转角度取决于 Preferences 对话框的 PCB Editor – General 页面中定义的 Rotation Step 值。
  • 按 X 或 Y 键，沿 X 轴或 Y 轴镜像文本对象。
  • 按 L 键，将文本对象翻转到电路板的另一面。
  • 按数字小键盘上的 + 和 - 键，在设计的所有可见层之间向前或向后循环切换，以快速更改放置层。

通过图形化编辑方式，您可以直接在设计空间中选择已放置的文本对象，并更改其位置、旋转角度、朝向和大小。

选中文本对象后，可使用以下编辑控制点：

选中的文本对象
选中的文本对象

  • 单击并拖动 B，使文本对象绕其参考点 A （以小 x 标记）旋转。
  • 单击并拖动 C，同时在垂直和水平方向上调整文本对象边界框的大小。
  • 单击并拖动 D，分别在垂直和水平方向上调整文本对象边界框的大小。
  • 单击文本对象上编辑控制点以外的任意位置 并拖动，即可重新定位。拖动时，可旋转或镜像注释文本：
    • 按 Spacebar 逆时针旋转文本对象，或按 Shift+Spacebar 顺时针旋转。旋转角度取决于 Preferences 对话框的 PCB Editor – General 页面中定义的 Rotation Step 值。
    • 按 X 或 Y 键，沿 X 轴或 Y 轴镜像文本对象。
  • 新放置的字符串对象的默认文本为 String。放置后（除非已在放置前或放置过程中更改），可通过 Properties 面板查看字符串属性，并在文本输入窗口中按需更改文本。
  • 软件支持在 PCB 的任意层上将文本对象直接放置为条形码符号，从而在制造过程中轻松将条形码印制到 PCB 上。有关将文本对象用作条形码的更多信息，请参阅添加条形码和徽标页面中的添加条形码部分。
  • 软件支持在 PCB 的任意层上将文本对象直接放置为二维码，从而在制造过程中轻松将二维码印制到 PCB 上。有关将文本对象用作二维码的更多信息，请参阅添加条形码和徽标页面中的添加二维码部分。

特殊字符串

文本对象可用于在当前 PCB 层上放置用户自定义文本，但可放置的并不only用户自定义文本。为便于生成文档，软件引入了 special strings 的概念。这些字符串用作设计、系统或项目信息的占位符，在生成输出时，这些信息将显示在 PCB 上。

设计、系统和设计参数特殊字符串的示例，分别显示为源字符串（第一张图）和转换后的结果（第二张图）。 
设计、系统和设计参数特殊字符串的示例，分别显示为源字符串（第一张图）和转换后的结果（第二张图）。

PCB 文档中可用的特殊字符串来自多个来源：

使用特殊字符串的注意事项

  • 特殊字符串以 .（点）字符开头（例如 .Layer_Name、 .Net_Count 等）。 如果字符串以“.”开头，则整个字符串都会被视为“特殊”字符串。引用用户参数时也使用此语法，即在参数名称前加上“.”（点）字符。
  • 若要在一段 PCB 文本中包含多个特殊字符串，请将每个特殊字符串用单引号（ ' ）括起来；例如：'.Pcb_File_Name_No_Path' '.Print_Date'。
  • 您还可以在拼接的特殊字符串之间使用文本、空格和特殊字符，例如：FileName= '.Pcb_File_Name_No_Path' : PrintDate = '.Print_Date'。
  • 项目和变体的参数名称中也可以使用空格和特殊字符。

  • 某些特殊字符串的值只有在生成相关输出时才能查看，包括 .Legend、.Plot_File_Name 和 .Printout_Name。大多数特殊字符串都可以在屏幕上查看。

    为 PCB 项目生成文档并发布到工作区时，需要通过某种方式指明文档所关联的条目及其修订版，以及发布所用的设计项目配置 和任何适用的驱动变体。为此，系统提供了一组特殊字符串，包括 .PCBConfigurationName、.ItemAndRevision 和 .VariantName。这些特殊字符串只有在生成输出时才会被解析（在 3D 模式下查看 PCB 时除外，因为这本身也被视为一种输出）。使用这些字符串提供的信息可显示在生成的输出中， 包括 Gerber/ODB++ 文件、最终原图打印、PCB 打印、PCB 3D 打印、PCB 3D 视频和装配图。
  • 特殊字符串会自动转换，以便在屏幕上显示。如果无法转换字符串，则会显示输入的字符串值或一条消息。例如，如果项目未纳入版本控制，并且在 PCB 上放置了特殊字符串 .VersionControl_RevNumber，则会显示消息 Not in Version Control。

  • 为了便于识别 特殊字符串，视图配置面板 提供了 Special Strings 选项。启用此选项后，所有由特殊字符串转换而来的已放置文本对象上，都会叠加显示（标注）未经转换的特殊字符串名称。

放置特殊字符串

要在 PCB 上使用特殊字符串，请先放置一个文本对象，然后在 Properties 面板中，从“文本”字段的下拉列表（String 模式）或  下拉列表（Frame 模式）中选择一个特殊字符串名称。

访问已放置字符串对象的特殊字符串。
访问已放置字符串对象的特殊字符串。

以下是可在 PCB 文档中使用的系统预定义特殊字符串：

  • .Application_BuildNumber – 当前加载 PCB 的软件版本。生成 Gerber 输出时，可使用此字符串记录创建设计时所用软件的构建版本。
  • .Arc_Count – PCB 上的圆弧数量。
  • .BlindVia_Count – PCB 上的盲孔数量。
  • .Board_Height – PCB 板的纵向尺寸。
  • .Board_Width – PCB 板的横向尺寸。 
  • .BuriedVia_Count – PCB 上的埋孔数量。
  • .Comment – 元件的注释字符串（在库编辑器中放置于任意层上，作为元件封装的一部分）。
  • .Component_Count – PCB 上的元件数量。
  • .ComponentMixed_Count – PCB 上具有混合焊盘的 元件数量。
  • .ComponentSMD_Count – PCB 上具有 SMD 焊盘的元件数量。
  • .ComponentThru_Count – PCB 上具有通孔焊盘的元件数量。
  • .ComputerName – 安装并运行该软件的计算机名称。
  • .CopperInner_Weight_Max – 内层的最大铜重。
  • .CopperOuter_Weight_Max – 外层的最大铜重。
  • .Designator – 元件的位号字符串（在库编辑器中放置于任意层上，作为元件封装的一部分）。
  • .Fill_Count – PCB 上的填充数量。
  • .Hole_Count – PCB 上的钻孔数量。
  • .Hole_Size_Min – PCB 上的最小孔径。
  • .Hole_Size_Num – PCB 上不同孔径的数量。
  • .Item – 生成的数据所关联的条目（例如 D-810-2000）。这些数据将用于制造该条目。
  • .ItemAndRevision – 生成的数据所关联的条目及其特定修订版， 格式为 <Item ID>-<Revision ID>（例如 D-810-2000-01.A.1）。这些数据将用于制造该条目的特定修订版。
  • .ItemRevision – 生成的数据所关联条目的特定修订版（例如 01.A.1）。数据存储在目标服务器上的该条目修订版中。
  • .ItemRevisionBase – 条目修订版命名方案中的基础级别部分（例如 1）。
  • .ItemRevisionLevel1 – 条目修订版命名方案中的第 1 级部分（例如 A）。
  • .ItemRevisionLevel1AndBase – 条目修订版命名方案中的第 1 级和基础级别部分（例如 A.1）。
  • .ItemRevisionLevel2 – 条目修订版命名方案中的第 2 级部分（例如 01）。
  • .ItemRevisionLevel2AndLevel1 – 条目修订版命名方案中的第 2 级和第 1 级部分（例如 01.A）。
  • .Layer_Count – PCB 上的铜层数量。
  • .Layer_Name – 放置该字符串的 层的名称。
  • .Legend – 机械钻孔图的符号图例。此字符串仅在放置于钻孔图层时有效。注意：这是一项旧版功能；如需更详细的钻孔信息，请放置钻孔表对象。
  • .MicroVia_Count – PCB 上的微孔数量。
  • .ModifiedDate – PCB 的修改日期戳； 该值会自动填充。示例： 23/09/2015。
  • .ModifiedTime – PCB 的修改时间戳； 该值会自动填充。
  • .Net_Count – PCB 上不同网络的总数。
  • .Net_Names_On_Layer – 指定层上所有网络的名称。此字符串仅在放置于内电层时有效。
  • .Pad_Count – PCB 上的焊盘数量。
  • .PadSMD_Count – PCB 上的 SMD 焊盘数量。
  • .PadThru_Count – PCB 上的通孔焊盘数量。
  • .Pattern – PCB 上使用的元件封装名称。
  • .Pcb_File_Name – PCB 文档的路径和文件名。
  • .Pcb_File_Name_No_Path – PCB 文档的文件名。
  • .PCBConfigurationName – 显示用于生成输出的数据集名称，该名称在 项目发布器中定义。请注意，默认的 Source、Fabrication 和 Assembly 配置的名称无法编辑 （例如，对于制造输出，.PCBConfigurationName 将显示 Fabrication）。 对于用户定义的自定义配置，使用此特殊字符串时会显示用户定义的名称 （显示图像）。
  • .Plot_File_Name – 对于生成的 Gerber 输出，此字符串表示 Gerber 绘图文件的文件名。对于打印输出，它表示输出中描绘的层。对于 ODB++ 输出，它表示存储文件的父文件夹名称。
  • .Poly_Count – PCB 上多边形的数量（包括多边形覆铜、内电层和分割平面）。
  • .Print_Date – 打印/绘图的日期。
  • .Print_Scale – 打印/绘图的缩放比例。
  • .Print_Time – 打印/绘图的时间。
  • .Printout_Name – 打印输出的名称。
  • .SlotHole_Count – PCB 上槽孔的数量。
  • .SolderMask_Bottom – 底层阻焊的可用情况。如果没有 底层阻焊层，该参数的值为 No mask。 如果有底层阻焊层但未定义其颜色，该参数的值为 No color。如果有底层阻焊层且已定义其颜色，该参数将显示颜色名称（Green、Black、Blue、Red 等）或其 RGBA 代码（例如 #FF0065FF）。
  • .SolderMask_Top – 顶层阻焊的可用情况。如果没有 顶层阻焊层，该参数的值为 No mask。 如果有顶层阻焊层但未定义其颜色，该参数的值为 No color。如果有顶层阻焊层且已定义其颜色，该参数将显示颜色名称（Green、Black、Blue、Red 等）或其 RGBA 代码（例如 #FF0065FF）。
  • .SquareHole_Count – PCB 上方孔的数量。
  • .StackedVia_Count – PCB 上堆叠过孔的数量。
  • .String_Count – PCB 上字符串的数量。
  • .Thru_Via_Count – PCB 上通孔过孔的数量。
  • .Total_Thickness – 电路板的厚度。
  • .Total_Thickness(Board Layer Stack) – 电路板层叠的厚度。
  • .Track_Count – PCB 上走线的数量。
  • .VariantName – 用于生成输出的设计变体。
  • .VersionControl_PrjFolderRevNumber – 项目的当前修订号，每次执行项目的完整提交（即包含项目文件）时都会递增。只有使用版本控制，此字符串才会包含信息。
  • .VersionControl_ProjFolderRevNumber – 项目的当前修订号，每次执行项目的完整提交（即包含项目文件）时都会递增。只有使用版本控制，此字符串才会包含信息。
  • .VersionControl_ProjFolderRevNumberShort – 项目的短格式 Git 哈希值（前八个字符）。 只有使用版本控制，此字符串才会包含信息。
  • .VersionControl_RevNumber – 文档的当前修订号。只有使用版本控制，此字符串才会包含信息。
  • .VersionControl_RevNumberShort – 文档当前修订版本的短格式 Git 哈希值（前八个字符）。只有使用版本控制，此字符串才会包含信息。
  • .Via_Count – PCB 上过孔的数量。
可用特殊字符串的完整列表还包括由用户定义的项目级参数派生的所有特殊字符串。
AI-LocalizedAI 翻译
如您发现任何问题，请选中相关文本/图片，并按 Ctrl + Enter 键向我们提交反馈。
Nav
Contents
功能可用性

您可使用的功能取决于您所采用的 Altium 解决方案——Altium Develop、Altium Agile Teams、Altium Agile Enterprise，或 Altium Designer（在有效订阅期内）。

如果您在实际软件中未看到文档中介绍的某项功能， 请联系 Altium Sales 了解更多信息。

旧版文档

Altium Designer 文档不再提供版本区分。如果您需要访问 Altium Designer 旧版本的文档，请前往其他安装程序页面的旧版文档部分。

Contents