advpl-debugging

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

ADVPL/TLPP Debugging

ADVPL/TLPP 调试

This skill provides a systematic methodology for diagnosing and resolving ADVPL/TLPP errors: a decision flow (compilation vs. runtime), a quick-diagnosis table by symptom, logging tool guidance (
Conout
,
FWLogMsg
,
ErrorBlock
), database lock diagnosis (
RecLock
/
MsUnlock
), and quick performance checks (wrong index, array growth in loops, Embedded SQL vs ISAM).
Activate this skill when the user reports an error message, a stack trace, a compilation failure, a hanging/locked record, a slow routine, or an AppServer crash/log to investigate. It does not cover generating new code from scratch (see
advpl-code-generation
), a general quality audit of working code (see
advpl-code-review
), restructuring code that already works correctly (see
advpl-refactoring
), or converting
.prw
to
.tlpp
(see
advpl-to-tlpp-migration
).
Reference fileRead when
reference.mdAlways -- debug methodology flow, quick diagnosis by symptom, logging tools, lock diagnosis, performance quick checks, common debugging mistakes
common-errors.mdLooking up a specific compilation or runtime error message (top 50 ADVPL/TLPP errors with cause and fix)
performance-tips.mdInvestigating a performance bottleneck in depth (query optimization, loop efficiency, memory)
本技能提供了一套用于诊断和解决ADVPL/TLPP错误的系统化方法:决策流程(编译 vs 运行时)、按症状分类的快速诊断表、日志工具使用指南(
Conout
、
FWLogMsg
、
ErrorBlock
)、数据库锁诊断(
RecLock
/
MsUnlock
),以及快速性能检查(索引错误、循环内数组增长、嵌入式SQL vs ISAM)。
当用户报告错误消息、堆栈跟踪、编译失败、记录挂起/锁定、例程运行缓慢,或是需要调查AppServer崩溃/日志时,激活本技能。本技能不涵盖从零生成新代码(参见
advpl-code-generation
)、对可正常运行的代码进行通用质量审计(参见
advpl-code-review
)、重构已能正确运行的代码(参见
advpl-refactoring
),或是将
.prw
转换为
.tlpp
(参见
advpl-to-tlpp-migration
)。
参考文件读取场景
reference.md始终读取 —— 调试方法流程、按症状快速诊断、日志工具、锁诊断、性能快速检查、常见调试错误
common-errors.md查找特定编译或运行时错误消息时(收录了前50个ADVPL/TLPP错误的原因及修复方法)
performance-tips.md深入调查性能瓶颈时(查询优化、循环效率、内存)