SAP-ABAP：模块化基础：子程序与Include程序（5篇） 第3篇：代码复用的另一条路径：Include程序的底层逻辑与基础用法
模块化基础：子程序与Include程序（5篇）
第3篇：代码复用的另一条路径：Include程序的底层逻辑与基础用法
子程序让我们可以在同一个程序内部消除重复代码，但它的复用范围仅限于“本程序”。如果你有多个独立的ABAP程序（例如多个报表）都需要使用同一段逻辑——比如通用的日期格式化函数、公共的权限检查，难道只能复制粘贴？当然不是。Include程序正是为解决跨程序代码复用而生的。本文将深入讲解Include程序的本质、加载机制，并对比子程序与Include的差异，帮你搞懂何时该用子程序、何时该用Include，实现最高效的代码复用。
一、为什么需要Include程序？
1.1 子程序的局限性
子程序（FORM/ENDFORM）是在主程序内部定义的，其他程序无法直接调用。如果你有三个报表都需要计算税后工资，你只能：
- 在每个报表中都写一遍相同的
FORM calc_net→ 违反DRY原则。 - 将子程序复制到三个程序中 → 维护成本高，修改需同步三处。
1.2 Include程序的解决方案
Include程序（也叫“包含程序”）是一段独立的ABAP源代码，可以被多个主程序使用INCLUDE语句嵌入到自己的代码中。编译时，INCLUDE语句的位置会被Include程序的实际内容替换，就像把那段代码直接写在那里一样。
主程序A: 主程序B: ... ... INCLUDE zincl_utils. INCLUDE zincl_utils. ... ...编译后，两个程序都拥有了zincl_utils中定义的子程序、常量等。
二、Include程序的本质与加载机制
2.1 本质：文本包含（预处理）
Include不是独立编译的单元。它仅仅是一个文本文件，在编译主程序时，ABAP编译器将INCLUDE指令替换为该文件的实际内容。这意味着：
- Include中定义的所有内容（
DATA、FORM、CONSTANTS等）会成为主程序的一部分。 - Include中不能包含独立的可执行语句（比如
WRITE），除非它被放在主程序的可执行区域。 - Include不能嵌套调用自己（会导致无限展开），且交叉引用（A包含B，B包含A）会被编译器检测并报错。
2.2 编译与激活顺序
- 修改Include文件后，必须重新激活所有引用它的主程序。否则主程序仍使用旧版代码。
- 事务码
SE38中可以创建Include程序，命名规则通常以Z开头，建议使用Z<主程序名>_<后缀>，如ZREPORT_UTILS。
2.3 Include的物理存储
Include程序与主程序一样，存储在表TADIR中（类型TYPE = 'PROG'，SUBC = 'I'表示Include）。可以通过SE38直接编辑和激活。
三、Include与子程序的全面对比
| 维度 | 子程序（FORM） | Include程序 |
|---|---|---|
| 复用范围 | 仅限本程序 | 可被多个主程序共享 |
| 定义位置 | 主程序内部 | 独立程序 |
| 调用方式 | PERFORM <form> | INCLUDE <include>（编译时嵌入） |
| 参数传递 | 支持USING/CHANGING | 无，直接共享全局变量 |
| 命名空间 | 主程序内部唯一 | 全局（不同Include中的同名子程序会冲突） |
| 调试 | 可单步进入 | 嵌入后成为主程序的一部分，调试时可见 |
| 维护 | 修改只需改主程序 | 修改Include后需重激活所有引用者 |
| 适用场景 | 程序内部逻辑分解 | 跨程序的公共常量、宏、通用子程序库 |
四、典型适用场景
4.1 全局常量池
多个程序使用相同的业务常量（如状态代码、公司代码等），可以定义在一个Include中。
Include文件ZCONSTANTS：
CONSTANTS: gc_status_active TYPE c LENGTH 2 VALUE '01', gc_status_inactive TYPE c LENGTH 2 VALUE '02', gc_company_1000 TYPE bukrs VALUE '1000'.主程序：
REPORT z_sales_report. INCLUDE zconstants. " 引入常量 ... IF lv_status = gc_status_active. ...4.2 公共子程序库
将常用的子程序（如日期转换、数值校验）集中到一个Include中，供多个程序调用。
IncludeZCOMMON_FORMS：
FORM format_date USING iv_date TYPE d RETURNING VALUE(rv_string) TYPE string. rv_string = |{ iv_date+6(2) }.{ iv_date+4(2) }.{ iv_date(4) }|. ENDFORM. FORM is_numeric USING iv_str TYPE string RETURNING VALUE(rv_flag) TYPE abap_bool. TRY. DATA(lv_temp) = CONV i( iv_str ). rv_flag = abap_true. CATCH cx_sy_conversion_no_number. rv_flag = abap_false. ENDTRY. ENDFORM.主程序：
REPORT z_payroll. INCLUDE zcommon_forms. ... PERFORM format_date USING sy-datum CHANGING lv_date_str.4.3 数据字典扩展类型
某些复杂类型（如嵌套结构）需要在多个程序中复用，可以通过Include声明。
" Include ZTYPES TYPES: BEGIN OF ty_address, street TYPE c LENGTH 30, city TYPE c LENGTH 20, END OF ty_address.主程序中INCLUDE ZTYPES后即可使用ty_address类型。
4.4 程序头部标准化注释
团队开发时，可以在每个程序开头Include一个标准注释块，包含作者、创建日期、修改历史等。
" Include ZHEADER *----------------------------------------------------------------------* * 程序名: &1 * 作者: 张三 * 创建: 2026-01-01 * 说明: 采购订单报表 *----------------------------------------------------------------------*主程序中使用INCLUDE ZHEADER，需要动态替换程序名？实际上不能动态替换，通常是纯静态文本。
五、基础用法与示例
5.1 创建Include程序
- 执行事务码
SE38。 - 输入以
Z或Y开头的名称，例如ZINCL_MATH。 - 选择程序类型为“包含程序”（
INCLUDE PROGRAM），属性中类型选I。 - 编写代码（只能包含声明和子程序，不能有直接可执行语句）。
- 激活。
5.2 在主程序中包含
REPORT z_main_program. INCLUDE zincl_math. " 包含数学函数 INCLUDE zincl_constants. " 包含常量定义 START-OF-SELECTION. PERFORM add USING 10 20 CHANGING lv_result. WRITE lv_result.5.3 使用INCLUDE时需要注意主程序的类型
- 可执行程序（Type 1）：可以在任何位置
INCLUDE，但INCLUDE不能包含可执行语句（除非在主程序的START-OF-SELECTION之后）。 - 模块池程序（Type M）：同样适用。
- 包含程序（Type I）：可以被
INCLUDE，本身不能直接执行。
六、注意事项与常见坑点
6.1 全局变量污染
Include中定义的变量会成为主程序的全局变量，可能导致意外修改。
" Include ZVAR DATA: gv_temp TYPE i.两个不同的主程序都包含此Include，各自拥有独立的gv_temp（因为是各自编译的），不会互相影响。但在同一主程序中，如果多个Include定义了同名全局变量，会引发激活错误（重复定义）。因此，Include中的全局变量命名应加前缀以避免冲突。
6.2 循环包含
INCLUDE A中包含INCLUDE B，而INCLUDE B中又包含INCLUDE A，编译器会报错INCLUDE recursion。
6.3 修改Include后的激活
修改Include后，所有引用该Include的主程序都必须重新激活。如果遗漏，主程序仍使用旧版本，可能导致逻辑不一致。SAP提供事务码SE38→“程序”→“重新生成”，可以批量激活依赖对象，但最好通过传输请求确保一致性。
6.4 Include中的子程序不能使用局部变量
由于Include的内容被“粘贴”到主程序，子程序内部可以访问主程序中的任何全局变量，这既是便利也是风险。建议Include中的子程序只使用参数传递，避免直接依赖主程序的全局变量，以保持独立性。
6.5 调试Include代码
在调试主程序时，如果执行到PERFORM一个定义在Include中的子程序，调试器会直接跳转到Include程序的源代码中，无需特殊设置。
七、选型决策：子程序 vs Include vs 函数模块
| 复用需求 | 推荐方案 | 理由 |
|---|---|---|
| 仅当前程序内部拆解逻辑 | 子程序 | 简单，作用域可控 |
| 多个程序共享通用子程序库 | Include + 子程序 | 共享代码，但需注意全局变量污染 |
| 需要独立的命名空间和异常处理 | 函数模块（SE37） | 更好的封装，支持异常和RFC |
| 面向对象多态 | 类和方法 | 最现代的方式 |
| 共享常量、类型、宏 | Include | 轻量级，适合声明式内容 |
经验法则：
- 如果只是声明（常量、类型）或简单的辅助子程序，Include + 子程序足够。
- 如果逻辑复杂、需要独立测试、或要发布给其他团队使用，优先考虑函数模块或类。
- 永远不要为了“复用”而滥用Include，导致程序耦合度升高。
八、总结
Include程序是ABAP实现跨程序代码复用的传统机制，通过编译时的文本包含，让多个主程序共享同一段源代码。它与子程序相辅相成：子程序负责程序内部逻辑的模块化，Include负责跨程序资源的共享。理解它们的差异与适用场景，可以帮助你在“避免重复”和“控制耦合”之间找到平衡点。
下一篇我们将聚焦子程序与Include程序的常见误用场景，剖析过度拆分、循环引用、全局变量污染等高频错误，并结合故障案例给出解决方案。
📌下篇预告：《避坑指南：子程序与Include程序的常见误用场景解析》
作者：你的ABAP学习伙伴
版本记录：2026年5月
💬 你是否曾因为修改Include后忘记激活主程序而苦苦排查问题？欢迎留言分享你的“血泪史”。