附录B · Eclipse ADT 用法与技巧

📄 [教程] SAP 官方课程中文库(本地 docs/SAP开发手册/sphinx/course-zh/):S4D400「初步了解 ABAP」「调试 ABAP 程序」、S4D401「使用 ABAP 测试主控室提高代码质量」「使用 ABAP 单元实施代码测试」、DOP100「介绍适用于 SAP BTP ABAP Environment 的 DevOps」(gCTS);Day2 练习脚本与培训录像(ADT 界面截图) 🔗 [官方] 安装 ADT(SAP 官方教程) · ADT 插件更新站点 · ADT 用户指南(ABAP Cloud 版 PDF,含官方键位表) · SAP Help Portal

本章定位:第 01–04 章的配套操作手册,装完环境后常备手边,卡在哪查哪,不用从头读。环境基线同教程(S/4HANA Cloud Public Edition,release 2608);ADT 版本随 Eclipse 插件更新,菜单名可能微调,键位一律以本机 Window → Preferences → General → Keys 查到的绑定为准。


1. 界面与透视图:先认门再干活

ADT 不是独立软件,是 Eclipse 里的一套"透视图 + 视图":**透视图(Perspective)**决定界面摆哪些面板,**视图(View)**是其中一块。日常只会用到三个透视图:

透视图

什么时候用

怎么进

ABAP

开发主战场:写代码、建对象、激活、跑控制台类

默认透视图;或 Window → Perspective → Open Perspective → Other… → ABAP

ABAP Debug

命中断点后自动打开:看变量、单步、断点

调试时自动打开,也可手动切换

ABAP Profiler(进阶)

性能分析(对应老事务码 SAT)

Open Perspective → Other… → ABAP Profiler

右上角那排图标就是透视图切换器;面板拖乱了用 Window → Perspective → Reset Perspective… 恢复默认。

六个必须认识的视图:

视图

打开方式

用途

关键技巧

Project Explorer

默认左侧

云端对象树:Favorite Packages、包、对象

工具栏 Link with Editor 让树跟着当前编辑器走

Outline

默认编辑器下方/右侧

当前源码结构(类/方法/字段、CDS 元素)

顶部输入框过滤符号,长类里定位方法最快

Problems

默认下方

语法/激活错误与警告,双击跳到出错行

右键 Show ABAP Problem Help 看长文本、打开激活日志

Console

运行控制台类后自动出现

out->write( ) 的输出

找不到时 Window → Show View → Other… → Console

Properties

编辑器下方标签

对象元数据:原语言、创建/修改人、时间戳

查"谁改的、什么时候改的"先看这里

Transport Organizer

Window → Show View → Other… → Transport Organizer

TR/任务的创建、检查、释放

默认只显示"我的可修改请求 + 最近两周已释放"

ADT 工程界面 (📄 培训录像 2.1 截帧:连上 D 租户后的 ADT 工程浏览界面,左侧 Project Explorer 即云端对象树)

💡 找不到视图时的万能入口:Window → Show View → Other…,输入名字搜索;布局调乱先 Reset Perspective,比逐个找回省事。 ⚠️ 调试、性能分析会自动切透视图,用完切回 ABAP,否则下次写代码找不到对象树。调试视图里的 Variables / Breakpoints / ABAP Internal Table 是后面第 6 节的常用面板。


2. 快捷键总表(只收录已核实键位)

先记 6 个就能开工:Ctrl+Shift+A 开对象、Ctrl+F3 激活、Shift+F1 格式化、Ctrl+1 快速修复、F3 跳定义、F9 跑控制台类。

快捷键

作用

适用范围

Ctrl+Shift+A

打开 ABAP 开发对象(名字/前缀/通配符)

ADT 专属

Ctrl+Shift+N

新建 ABAP 开发对象(等价于 New 向导)

ADT 专属

Ctrl+Shift+G

使用位置清单(Where-Used)

ADT 专属

Ctrl+F3

激活当前开发对象(生成运行时版本)

ADT 专属

Ctrl+S

保存(只存未激活版本,不生效)

Eclipse 通用

Shift+F1

格式化整段源码(ABAP Pretty Printer)

ADT 专属

Ctrl+Shift+F1

只格式化选中的代码块

ADT 专属

Ctrl+1

Quick Fix / Quick Assist(生成方法、行为池类等)

ADT 专属

Ctrl+Space

代码补全(对象名、注解、方法签名)

ADT 专属

F3

跳到定义(Ctrl+单击同效)

ADT 专属

F2

显示光标处元素的说明/注解 tooltip

ADT 专属

F9

Run As → ABAP Application (Console) 运行控制台类

ADT 专属

Ctrl+Shift+F2

启动 ATC 检查

ADT 专属

Ctrl+Shift+F10

启动 ABAP Unit 测试

ADT 专属

Ctrl+Alt+F5

ABAP Package Check(包检查,以本机 ADT 版本为准)

ADT 专属

F5

调试:步入(Step Into)

Eclipse 通用(调试)

F6

调试:步过(Step Over)

Eclipse 通用(调试)

F7

调试:跳出(Step Return)

Eclipse 通用(调试)

F8

调试:继续(Resume)

Eclipse 通用(调试)

Ctrl+H

打开 Search 对话框(在 ABAP 标签页搜源码/对象)

Eclipse 通用

Ctrl+3

Quick Access(官方文档称 Quick Launch):搜命令/视图/首选项

Eclipse 通用

Ctrl+Shift+R

Open Resource:按文件名打开工作区资源

Eclipse 通用

Alt+← / Alt+→

编辑器历史后退 / 前进(F3 跳走后回来)

Eclipse 通用

Ctrl+M

最大化 / 还原当前编辑器

Eclipse 通用

补充:SAP 官方键位表里还列了这些,按需使用(出处同上,不在本附录展开):

快捷键

作用

适用范围

Ctrl+F2

语法检查(只检查、不激活)

ADT 专属

Ctrl+Shift+F3

激活所有未激活对象

ADT 专属

F1

上下文帮助(源码编辑器里打开 ABAP 关键字文档)

ADT 专属

Ctrl+<

注释选中代码

ADT 专属

Ctrl+Shift+<

取消注释

ADT 专属

Ctrl+O

Quick Outline(当前文件内快速定位)

Eclipse 通用

⚠️ 键位是本机状态不是标准答案:Eclipse 允许改键、插件也会抢键;macOS 上官方指南还提示要确认用 Command 还是 Ctrl(Window → Preferences → General → Keys 里有 Modifier 选项卡)。按了没反应,先查绑定再怀疑 ADT。


3. 日常操作:找对象、搜代码、看使用位置

3.1 新建对象:一个向导走天下

步骤

操作

为什么

1

Project Explorer 里右键目标包 → New → Other ABAP Repository Object

云上所有对象类型都在这个向导:表/CDS/BDEF/服务/消息类/传输请求…

2

搜索框输入类型关键字(table、cds、class…)→ Next

不用死记分类路径,搜英文关键字最快

3

填名字(按第 09 章命名规范)→ Next

包决定传输边界,名字决定可读性

4

选已有 TR 或新建 TR → Finish

公有云没有"临时对象",创建即挂请求

5

Ctrl+F3 激活后才真正生成运行时对象

新建只是建了未激活版本

3.2 打开对象:三条路

  • 知道名字:Ctrl+Shift+A(Navigate → Open ABAP Development Object…)→ 输名字/前缀,支持 *、? 通配符;对象多时可在结果列表上方的过滤区按对象类型/包收窄。

  • 在树里:Project Explorer 双击对象;先把常用包加进 Favorite Packages,省得每次翻。

  • 从代码:光标放对象名上按 F3(或 Ctrl+单击)跳定义;Alt+← 返回原处。

3.3 搜索:别用普通文件搜索凑合

想找什么

用什么

入口

按对象名找

ABAP Object Search

Ctrl+H → ABAP Object Search 标签

按源码文本跨包找

ABAP Source Search

Ctrl+H → ABAP Source Search 标签;或对象右键 Search Content…

找对象被谁用

Where-Used

右键或工具栏 Get Where-Used List…(官方键 Ctrl+Shift+G)

⚠️ Eclipse 普通 File/Text Search 对 ABAP 仓库对象结果可能不全(对象不在本地文件系统)。搜 ABAP 内容一定用 Ctrl+H 里的 ABAP 标签页。 💡 Where-Used 是改接口/改表前的影响面分析工具:结果按关系分组,可逐层展开,双击直接跳源码。

3.4 收藏包与跳转习惯

  • 收藏包:Project Explorer 右键 Favorite Packages → Add Package… → 输包名搜索 → 选中确定。包一多,这是唯一不迷路的办法;常用跳转记 F3 定义、Alt+←/→ 历史、Ctrl+3 找命令。


4. 编辑器技巧:保存 ≠ 激活

4.1 四个状态、四个动作(最核心的一张表)

动作

生成了什么

是否生效

说明

新建

inactive 版本

❌

只在你本地工作区里

保存 Ctrl+S

更新 inactive 版本

❌

不生成运行时对象;此时打断点也打不上

激活 Ctrl+F3

active 版本 → 运行时对象

✅

激活前对整对象做语法检查,有错则失败

运行 / 传输

只用 active 版本

—

TR 内对象未全部激活则无法释放

⚠️ 新人第一大坑:以为 Ctrl+S 保存就生效。保存只影响自己的编辑区,激活才影响系统。 💡 一次改多个对象:激活按钮旁的下拉 → Activate Inactive ABAP Development Objects…,在未激活对象工作清单里批量激活(按 TR 分组)。

4.2 格式化与代码风格

  • 整段 Shift+F1;选中块 Ctrl+Shift+F1;也可右键 Source Code → Format。

  • 格式规则按项目走:项目右键 Properties → ABAP Development → Editors → Source Code Editors 调缩进/大小写风格。

  • 格式化只改排版不改语义;先格式化再激活,免得报错里夹一堆排版噪音。

4.3 Quick Fix(Ctrl+1):让 ADT 写样板

光标放报错/警告行按 Ctrl+1,常用场景:

  • 类里定义了方法但没实现 → 生成方法实现;

  • 实现接口后方法缺失 → 批量补实现;

  • BDEF 首行按 Ctrl+1 → 生成行为池类(第 04 章的标准动作);

  • 对象不存在 → Quick Fix 直接拉起创建向导(缺类、缺函数模块等)。

💡 Quick Fix 可能一次改多个位置,执行前扫一眼预览;涉及接口/签名的改动尤其要慢一步。 ⚠️ 它能补出实现,补不出正确的业务逻辑——别用 Quick Fix 掩盖设计问题。

4.4 语法检查与 Problems 视图

  • 编辑器默认边写边查(停止输入约 500 ms 后触发),错误/警告进 Problems 视图。

  • 手动检查 Ctrl+F2;激活时也会对整对象再做一次语法检查。

  • Problems 里双击跳到出错行;右键 Show ABAP Problem Help 看长文本;DDIC 类对象激活失败还能打开激活日志。

  • 激活失败弹窗问"是否继续激活"时选否,回 Problems 修完再激活。

4.5 比较版本:Local History vs Revision History

想比什么

操作

注意

和本机历史保存点比

右键对象 → Compare With → Local History

只在本机 workspace(.metadata)里,换机/清 workspace 就没

和已传输版本比

右键对象 → Compare With → Revision History

看 TR/激活产生的版本,跨系统排障最有用

和另一个 ABAP 系统比

右键对象 → Compare With → <ABAP project>

例:核对修正是否已传到测试系统

结果在 Compare Editor 双栏显示、差异高亮,双击差异可跳转。


5. 传输请求(TR)与 gCTS

5.1 先理解链路

公有云里对象变更必须挂传输请求,没有"先随便建个临时对象"这回事。释放 TR 后,对象进入关联的 gCTS Git 仓库/软件组件,再由负责人导入下游租户:

D 开发租户(ADT 开发 + 激活)→ 释放 TR → gCTS 仓库(软件组件)→ 测试租户验证 → 生产租户

⚠️ 公司铁律(第 09 章):D→TEST→PROD 走 gCTS,不要越级发布;连任何租户前先经负责人同意。 💡 一个需求一个 TR,描述写清需求/工单号——释放之后你只能靠描述认出它。

5.2 Transport Organizer 视图

  • 打开:Window → Show View → Other… → Transport Organizer。

  • 默认显示当前用户可修改的 TR/任务 + 最近两周已释放的,用视图里的 Filter 过滤。

  • 新建 TR:视图工具栏/右键 New Transport Request,或 File → New → Other… → ABAP → Transport Request;填类型、描述、目标(不填目标时请求为 LOCAL,云上按租户规则处理)。

  • 打开某个 TR 的 Request Editor 可看对象清单、加人(Add…)、改 owner。

5.3 释放前的检查清单(照着打勾)

检查项

怎么查

不通过的后果

所有对象已激活

Problems 无红叉,对象无 inactive 标记

TR 无法释放

ATC 无 error

跑 Ctrl+Shift+F2,ATC Problems 清零

质量门禁拦截/带病上线

对象清单没有多余对象

Request Editor 里逐个看

无关对象被带进生产

描述/工单号可追溯

TR 描述字段

下游排障找不到来源

下游系统就绪

与负责人确认导入窗口

卡在导入环节

先 Task 后 Request 释放

Transport Organizer

请求释放不出去

⚠️ 只有 TR owner 能释放;任务没释放完,请求释放不了。释放时自动跑一致性检查,失败信息在 Problems 视图。 ⚠️ 对象被同事锁着(编辑器锁或已在别人 TR 里)时不要硬改:先协调解锁/换 owner,否则激活失败或改动丢失。


6. 调试:断点、ABAP Debug 透视图与单步

6.1 打断点(前提:对象已激活)

  • 双击编辑器行号左侧边距,或右键边距 → Toggle Breakpoint。

  • 断点是用户级外部断点:只对你的用户生效、跨应用服务器有效、退出登录仍保留——调试完记得删。

  • 程序/类必须先激活才能打断点,没激活就"打不上"。

6.2 进入调试:控制台类的标准入口

  1. 在 if_oo_adt_classrun~main 里想停的行打上断点;

  2. F9(Run As → ABAP Application (Console))运行;

  3. 命中断点后 ADT 打开 ABAP Debug 透视图(可能先问是否切换,可勾"记住我的决定");

  4. 调完切回 ABAP 透视图。

6.3 单步与控制

快捷键

动作

什么时候用

F5

Step Into 步入

想进被调方法内部看

F6

Step Over 步过

把一段/一个方法当一步走,最常用

F7

Step Return 跳出

当前方法看够了回调用处

F8

Resume 继续

跑到下一个断点;没有断点就结束调试

Debug 透视图常用面板:Debug(调用栈)、Variables(变量值)、Breakpoints(断点清单)、ABAP Internal Table(内部表内容,可改值/插行/删行)。

6.4 条件断点、语句断点、观察点

  • 条件断点:Breakpoints 视图选中断点,在 Condition 字段填条件(如 sy-index > 20)回车,满足条件才停。

  • 语句断点:Breakpoints 视图工具栏下拉 → Add Statement Breakpoint…,输语句(如 CLEAR、EXIT),任何位置的该语句都会停。

  • 异常断点:同上 → Add Exception Breakpoint…,异常抛出时停,适合抓 CX_*。

  • 观察点:Variables 视图里右键变量 → Set Watchpoint,值变化时停。

💡 调试时可直接在编辑器改代码,但改完必须重新激活并重启调试会话(官方明确建议),否则看到的是旧运行时版本。 ⚠️ 后台作业/异步请求(Application Job、入站 API)的调试通常需要额外权限或管理员配置(以租户侧配置为准),别在联调现场现试。


7. 代码质量三道关:ATC / ABAP Unit / Package Check

工具

快捷键 / 入口

查什么

结果在哪

语法检查

Ctrl+F2;激活时自动

语法错误/警告,阻断激活

Problems 视图

ATC

Ctrl+Shift+F2;右键 Run As → ABAP Test Cockpit(或 With… 指定检查变式)

性能、安全、规范、可维护性等静态检查

ATC Problems 视图(Worklist)

ABAP Unit

Ctrl+Shift+F10;右键 Run As → ABAP Unit Test

单元测试(FOR TESTING 方法)

ABAP Unit 视图

Package Check

Ctrl+Alt+F5;右键 Run As → ABAP Package Check

包依赖/包契约违规(以本机 ADT 版本为准)

结果视图

ATC 要点:

  • 一次检查用一个检查变式;Run As → ABAP Test Cockpit With… 可临时换更严格的变式。

  • 结果在 ATC Problems 视图按 Worklist 累积;双击跳源码;右键可 Recheck。

  • 确认误报才抑制:行尾伪注释(如 "#EC NEEDED)或语句内 pragma(如 ##NEEDED);能修的先修,别用它盖真问题。

ABAP Unit 要点:

  • 测试类用 FOR TESTING 标记,测试方法不能有参数;断言用 CL_ABAP_UNIT_ASSERT。

  • 全局类的本地测试类写在 Test Classes 标签页;代码模板 testClass 可一键生成骨架。

  • 结果按 program / test class / test method 三层展开,失败看 Failure Trace,可 Re-run Tests。

💡 把提交流程固化成肌肉记忆:Ctrl+F3 激活 → Ctrl+Shift+F2 ATC → Ctrl+Shift+F10 单测 → 释放 TR。 ⚠️ 公司规范(第 09 章):每个对象必须挂 TR,gCTS 提交前必须"激活 + ATC 检查"。


8. 连接与 SSO 排错

ABAP Cloud Project 走浏览器 SSO(SAML):创建项目时点 Open Logon Page in Browser → 浏览器登录公司 IdP → 回 Eclipse 提示 logged on。日常排错按下面顺序查:

症状

常见原因

处理

打开对象提示未登录/会话过期

SSO 会话到期

按提示重新登录;先在浏览器登录租户 Fiori 再回 ADT 通常更快

点登录后浏览器不弹

外部浏览器未配置/被拦截

Window → Preferences → General → Web Browser 选外部浏览器;检查弹窗拦截

项目离线/红叉、对象打不开

网络中断、后台任务未完成、会话失效

等右下角进度条跑完 → 右键项目 Refresh → 仍不行 Close Project 再 Open Project

连不上/证书报错

代理、VPN、租户 URL 写错

核对 URL(不能带空格)、确认能访问 IdP 与租户;找负责人

💡 workspace 必须放本地盘:Eclipse 的 .metadata(含 Local History、偏好、索引)不适合放 iCloud/OneDrive/网络盘,容易锁冲突、变慢、丢本地历史。建议用 ~/eclipse-workspace/ 这类纯本地路径。 ⚠️ .metadata 不要手动删:删了本地历史全没。真损坏时新建 workspace,重新建 ABAP Cloud Project 连回来即可——代码在云端,不在本地。 ⚠️ 公司红线:连接任何租户(含测试连通性)前必须经负责人同意;开发只在 D 租户。


9. 事务码 → ADT 对照表(老习惯迁移)

公有云没有 SAP GUI 开发事务码。下表只用于把老 ABAP 的肌肉记忆翻译成 ADT 操作:

老事务码

原来干什么

ADT 里怎么做

SE80

对象导航器/仓库浏览器

Project Explorer + Ctrl+Shift+A + Ctrl+H 搜索

SE38

程序编辑器

打开类/程序 → ABAP 源码编辑器(可运行对象用 if_oo_adt_classrun 控制台类)

SE37

函数构建器

函数组/函数模块编辑器(Ctrl+Shift+A 打开;云上优先用类/接口/API)

SE24

类构建器

Class editor(类定义/实现分标签页)

SE11

数据字典

New → Other ABAP Repository Object → Dictionary(DOMA/DTEL/TABL/DDLS…)+ 表编辑器

SE16 / SE16N

数据浏览

右键表/视图 → Open Data Preview(默认前 100 行)

SE01 / SE09 / SE10

传输组织器

Transport Organizer 视图(第 5 节)

SE91

消息类

New → Other ABAP Repository Object → Message Class,消息编辑器

SE18 / SE19

BAdI 定义/实现

Enhancement Spot / BAdI 实现(云上只实现 released BAdI)

SE30 / SAT

运行时分析

Run As → ABAP Profiler,结果在 ABAP Profiler 透视图

ST05

SQL 跟踪

ADT 的 SQL Trace 入口(项目/包的右键菜单,具体位置随 ADT 版本略有差异)→ 浏览器里看跟踪结果

SCI

代码检查器

ATC(Ctrl+Shift+F2)

ST22

运行时错误

运行时错误对话框 → Show(ABAP Runtime Error Viewer)

SM37

后台作业监控

Fiori 应用 Application Jobs(第 06 章)

SE93

事务码维护

云上不建事务码;入口用 Fiori App / Service Binding

💡 记不住时抓特征:对象类 → Ctrl+Shift+A;内容类 → Ctrl+H;传输类 → Transport Organizer;运行类 → F9 / Run As;质量类 → Ctrl+Shift+F2。 ⚠️ 别在云租户里找 SE80/SE38——找不到不是权限问题,是公有云不提供开发事务码入口。ADT 能打开部分嵌入的 SAP GUI 对象,但主线开发全在 ADT。


10. 新人常见坑 Top10

#

坑

症状

正确姿势

1

把保存当激活

Ctrl+S 后运行还是旧逻辑、断点打不上

改完必须 Ctrl+F3,Problems 无错、对象非 inactive

2

断点打不上

边距点了没效果/运行不停

先激活;确认没开 Skip All Breakpoints;外部请求注意用户与系统

3

激活失败还点"是"

对象带错误激活,后面更乱

选"否",回 Problems 修完再激活

4

TR 选错/一锅乱炖

对象挂到别人请求、无关对象混进生产

一个需求一个 TR,创建时写清描述;释放前看对象清单

5

对象被锁/激活被锁

提示 object locked、无法激活

协调同事解锁/换 owner;别在多个 TR 同时挂同一对象

6

格式化按错键

按了没反应/只格式化了一小段

整段 Shift+F1,选中块 Ctrl+Shift+F1;不行查 Preferences → General → Keys

7

用普通搜索代替 ABAP 搜索

搜不到标准对象/结果不全

Ctrl+H → ABAP Source Search / ABAP Object Search

8

把 Local History 当版本管理

换电脑/清 workspace 历史全丢

长期版本看 Revision History + TR;重要改动及时提交

9

控制台类跑不出结果

F9 后没输出

实现 if_oo_adt_classrun~main;确认 Console 视图打开;确认已激活

10

workspace 放同步盘/网络盘

启动慢、锁冲突、本地历史丢

workspace 放本地磁盘,专机专用


11. 上手自查清单

  • 能在 ABAP / ABAP Debug / ABAP Profiler 透视图之间切换,视图关掉能找回来

  • 收藏了自己的包,Ctrl+Shift+A 能按名字打开任意对象

  • 知道"保存 ≠ 激活",Ctrl+S 后一定再 Ctrl+F3

  • Shift+F1 格式化、Ctrl+1 Quick Fix 能熟练用

  • 会看 Problems 视图,激活失败能定位到具体行

  • 会 Compare With → Local History / Revision History

  • 能说清 TR → gCTS → 下游租户的链路,释放前会打勾检查清单

  • 会打断点、进 ABAP Debug 透视图、F5–F8 单步、看 Variables / ABAP Internal Table

  • 会跑 ATC(Ctrl+Shift+F2)和 ABAP Unit(Ctrl+Shift+F10)

  • SSO 过期、项目离线、浏览器不弹登录页这三种情况能自己处理

  • 老事务码(SE80/SE38/SE11/SE16/ST22…)都能翻译成 ADT 操作


➡️ 下一步