附录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 |
开发主战场:写代码、建对象、激活、跑控制台类 |
默认透视图;或 |
ABAP Debug |
命中断点后自动打开:看变量、单步、断点 |
调试时自动打开,也可手动切换 |
ABAP Profiler(进阶) |
性能分析(对应老事务码 SAT) |
|
右上角那排图标就是透视图切换器;面板拖乱了用 Window → Perspective → Reset Perspective… 恢复默认。
六个必须认识的视图:
视图 |
打开方式 |
用途 |
关键技巧 |
|---|---|---|---|
Project Explorer |
默认左侧 |
云端对象树:Favorite Packages、包、对象 |
工具栏 Link with Editor 让树跟着当前编辑器走 |
Outline |
默认编辑器下方/右侧 |
当前源码结构(类/方法/字段、CDS 元素) |
顶部输入框过滤符号,长类里定位方法最快 |
Problems |
默认下方 |
语法/激活错误与警告,双击跳到出错行 |
右键 |
Console |
运行控制台类后自动出现 |
|
找不到时 |
Properties |
编辑器下方标签 |
对象元数据:原语言、创建/修改人、时间戳 |
查"谁改的、什么时候改的"先看这里 |
Transport Organizer |
|
TR/任务的创建、检查、释放 |
默认只显示"我的可修改请求 + 最近两周已释放" |
(📄 培训录像 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 跑控制台类。
快捷键 |
作用 |
适用范围 |
|---|---|---|
|
打开 ABAP 开发对象(名字/前缀/通配符) |
ADT 专属 |
|
新建 ABAP 开发对象(等价于 New 向导) |
ADT 专属 |
|
使用位置清单(Where-Used) |
ADT 专属 |
|
激活当前开发对象(生成运行时版本) |
ADT 专属 |
|
保存(只存未激活版本,不生效) |
Eclipse 通用 |
|
格式化整段源码(ABAP Pretty Printer) |
ADT 专属 |
|
只格式化选中的代码块 |
ADT 专属 |
|
Quick Fix / Quick Assist(生成方法、行为池类等) |
ADT 专属 |
|
代码补全(对象名、注解、方法签名) |
ADT 专属 |
|
跳到定义(Ctrl+单击同效) |
ADT 专属 |
|
显示光标处元素的说明/注解 tooltip |
ADT 专属 |
|
Run As → ABAP Application (Console) 运行控制台类 |
ADT 专属 |
|
启动 ATC 检查 |
ADT 专属 |
|
启动 ABAP Unit 测试 |
ADT 专属 |
|
ABAP Package Check(包检查,以本机 ADT 版本为准) |
ADT 专属 |
|
调试:步入(Step Into) |
Eclipse 通用(调试) |
|
调试:步过(Step Over) |
Eclipse 通用(调试) |
|
调试:跳出(Step Return) |
Eclipse 通用(调试) |
|
调试:继续(Resume) |
Eclipse 通用(调试) |
|
打开 Search 对话框(在 ABAP 标签页搜源码/对象) |
Eclipse 通用 |
|
Quick Access(官方文档称 Quick Launch):搜命令/视图/首选项 |
Eclipse 通用 |
|
Open Resource:按文件名打开工作区资源 |
Eclipse 通用 |
|
编辑器历史后退 / 前进(F3 跳走后回来) |
Eclipse 通用 |
|
最大化 / 还原当前编辑器 |
Eclipse 通用 |
补充:SAP 官方键位表里还列了这些,按需使用(出处同上,不在本附录展开):
快捷键 |
作用 |
适用范围 |
|---|---|---|
|
语法检查(只检查、不激活) |
ADT 专属 |
|
激活所有未激活对象 |
ADT 专属 |
|
上下文帮助(源码编辑器里打开 ABAP 关键字文档) |
ADT 专属 |
|
注释选中代码 |
ADT 专属 |
|
取消注释 |
ADT 专属 |
|
Quick Outline(当前文件内快速定位) |
Eclipse 通用 |
⚠️ 键位是本机状态不是标准答案:Eclipse 允许改键、插件也会抢键;macOS 上官方指南还提示要确认用 Command 还是 Ctrl(
Window → Preferences → General → Keys里有 Modifier 选项卡)。按了没反应,先查绑定再怀疑 ADT。
3. 日常操作:找对象、搜代码、看使用位置
3.1 新建对象:一个向导走天下
步骤 |
操作 |
为什么 |
|---|---|---|
1 |
Project Explorer 里右键目标包 → |
云上所有对象类型都在这个向导:表/CDS/BDEF/服务/消息类/传输请求… |
2 |
搜索框输入类型关键字( |
不用死记分类路径,搜英文关键字最快 |
3 |
填名字(按第 09 章命名规范)→ Next |
包决定传输边界,名字决定可读性 |
4 |
选已有 TR 或新建 TR → Finish |
公有云没有"临时对象",创建即挂请求 |
5 |
|
新建只是建了未激活版本 |
3.2 打开对象:三条路
知道名字:
Ctrl+Shift+A(Navigate → Open ABAP Development Object…)→ 输名字/前缀,支持*、?通配符;对象多时可在结果列表上方的过滤区按对象类型/包收窄。在树里:Project Explorer 双击对象;先把常用包加进 Favorite Packages,省得每次翻。
从代码:光标放对象名上按
F3(或 Ctrl+单击)跳定义;Alt+←返回原处。
3.3 搜索:别用普通文件搜索凑合
想找什么 |
用什么 |
入口 |
|---|---|---|
按对象名找 |
ABAP Object Search |
|
按源码文本跨包找 |
ABAP Source Search |
|
找对象被谁用 |
Where-Used |
右键或工具栏 |
⚠️ 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 版本 |
❌ |
只在你本地工作区里 |
保存 |
更新 inactive 版本 |
❌ |
不生成运行时对象;此时打断点也打不上 |
激活 |
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
想比什么 |
操作 |
注意 |
|---|---|---|
和本机历史保存点比 |
右键对象 → |
只在本机 workspace( |
和已传输版本比 |
右键对象 → |
看 TR/激活产生的版本,跨系统排障最有用 |
和另一个 ABAP 系统比 |
右键对象 → |
例:核对修正是否已传到测试系统 |
结果在 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 |
跑 |
质量门禁拦截/带病上线 |
对象清单没有多余对象 |
Request Editor 里逐个看 |
无关对象被带进生产 |
描述/工单号可追溯 |
TR 描述字段 |
下游排障找不到来源 |
下游系统就绪 |
与负责人确认导入窗口 |
卡在导入环节 |
先 Task 后 Request 释放 |
Transport Organizer |
请求释放不出去 |
⚠️ 只有 TR owner 能释放;任务没释放完,请求释放不了。释放时自动跑一致性检查,失败信息在 Problems 视图。 ⚠️ 对象被同事锁着(编辑器锁或已在别人 TR 里)时不要硬改:先协调解锁/换 owner,否则激活失败或改动丢失。
6. 调试:断点、ABAP Debug 透视图与单步
6.1 打断点(前提:对象已激活)
双击编辑器行号左侧边距,或右键边距 →
Toggle Breakpoint。断点是用户级外部断点:只对你的用户生效、跨应用服务器有效、退出登录仍保留——调试完记得删。
程序/类必须先激活才能打断点,没激活就"打不上"。
6.2 进入调试:控制台类的标准入口
在
if_oo_adt_classrun~main里想停的行打上断点;F9(Run As → ABAP Application (Console))运行;命中断点后 ADT 打开 ABAP Debug 透视图(可能先问是否切换,可勾"记住我的决定");
调完切回 ABAP 透视图。
6.3 单步与控制
快捷键 |
动作 |
什么时候用 |
|---|---|---|
|
Step Into 步入 |
想进被调方法内部看 |
|
Step Over 步过 |
把一段/一个方法当一步走,最常用 |
|
Step Return 跳出 |
当前方法看够了回调用处 |
|
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
工具 |
快捷键 / 入口 |
查什么 |
结果在哪 |
|---|---|---|---|
语法检查 |
|
语法错误/警告,阻断激活 |
Problems 视图 |
ATC |
|
性能、安全、规范、可维护性等静态检查 |
ATC Problems 视图(Worklist) |
ABAP Unit |
|
单元测试( |
ABAP Unit 视图 |
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+F2ATC →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 通常更快 |
点登录后浏览器不弹 |
外部浏览器未配置/被拦截 |
|
项目离线/红叉、对象打不开 |
网络中断、后台任务未完成、会话失效 |
等右下角进度条跑完 → 右键项目 |
连不上/证书报错 |
代理、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 + |
SE38 |
程序编辑器 |
打开类/程序 → ABAP 源码编辑器(可运行对象用 |
SE37 |
函数构建器 |
函数组/函数模块编辑器( |
SE24 |
类构建器 |
Class editor(类定义/实现分标签页) |
SE11 |
数据字典 |
|
SE16 / SE16N |
数据浏览 |
右键表/视图 → |
SE01 / SE09 / SE10 |
传输组织器 |
Transport Organizer 视图(第 5 节) |
SE91 |
消息类 |
|
SE18 / SE19 |
BAdI 定义/实现 |
Enhancement Spot / BAdI 实现(云上只实现 released BAdI) |
SE30 / SAT |
运行时分析 |
|
ST05 |
SQL 跟踪 |
ADT 的 SQL Trace 入口(项目/包的右键菜单,具体位置随 ADT 版本略有差异)→ 浏览器里看跟踪结果 |
SCI |
代码检查器 |
ATC( |
ST22 |
运行时错误 |
运行时错误对话框 → |
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 |
把保存当激活 |
|
改完必须 |
2 |
断点打不上 |
边距点了没效果/运行不停 |
先激活;确认没开 |
3 |
激活失败还点"是" |
对象带错误激活,后面更乱 |
选"否",回 Problems 修完再激活 |
4 |
TR 选错/一锅乱炖 |
对象挂到别人请求、无关对象混进生产 |
一个需求一个 TR,创建时写清描述;释放前看对象清单 |
5 |
对象被锁/激活被锁 |
提示 object locked、无法激活 |
协调同事解锁/换 owner;别在多个 TR 同时挂同一对象 |
6 |
格式化按错键 |
按了没反应/只格式化了一小段 |
整段 |
7 |
用普通搜索代替 ABAP 搜索 |
搜不到标准对象/结果不全 |
|
8 |
把 Local History 当版本管理 |
换电脑/清 workspace 历史全丢 |
长期版本看 Revision History + TR;重要改动及时提交 |
9 |
控制台类跑不出结果 |
F9 后没输出 |
实现 |
10 |
workspace 放同步盘/网络盘 |
启动慢、锁冲突、本地历史丢 |
workspace 放本地磁盘,专机专用 |
11. 上手自查清单
能在 ABAP / ABAP Debug / ABAP Profiler 透视图之间切换,视图关掉能找回来
收藏了自己的包,
Ctrl+Shift+A能按名字打开任意对象知道"保存 ≠ 激活",
Ctrl+S后一定再Ctrl+F3Shift+F1格式化、Ctrl+1Quick 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 操作
➡️ 下一步
回环境准备章:01 · 环境准备与开发工具
开始第一个实操:03 · 门② ABAP Cloud 基础与数据字典