KEIL C51 · TROUBLESHOOTING
Keil C51 编译失败怎么排查
STC 工程使用本机 Keil C51 编译。编译失败时，最有价值的不是“Target not created”，而是第一条错误和它前面的文件、行号。下面是一套固定顺序，避免在日志里来回跳。
1. 先确认编译器真的被调用
如果日志里没有 C51.exe 或 BL51 的输出，而是“找不到命令”，问题在工具链路径，不在代码。
- Keil C51 是否安装在默认目录，或 MCU Pilot 里配置的路径是否正确。
- 路径里是否有中文、空格、特殊符号；能改英文路径就改。
- 是否有多个 Keil 版本，环境变量指向了另一个。
2. 看第一条 error
main.c(23): error C202: 'P1': undefined identifier main.c(24): error C141: syntax error near '=' Target not created.
这里第一条是 undefined identifier，通常是头文件没包含、型号头文件不匹配，或寄存器名写错。后面的语法错误往往是第一条错误引起的连锁反应。
3. 检查头文件和型号
STC8 与 STC15 的头文件不能混用；同一系列不同型号的寄存器也可能不同。确认：
- 工程选择的型号和
#include的头文件一致。 - 没有同时包含两个版本的芯片头文件。
- 没有把用户自定义的
P1宏和官方头文件冲突。
AI 修改代码时，最好把“型号 + 头文件 + 引脚表”一起给它。只给一段报错，模型容易改错寄存器。
4. 让 AI 按日志修复
MCU Pilot 的做法是把完整编译日志回传给 AI，并限定它只改导致错误的文件。比起复制一段代码去聊天窗口，这种方式保留了工程上下文。
修复后仍然要重新编译，不能只看 AI 的解释。编译通过、HEX 生成，才算完成。
5. 编译通过但烧录失败
这时问题通常不在 C51，而在下载环节：串口被占用、下载器驱动、冷启动时序、型号或 IRC 频率不一致。先确认串口能打开，再确认下载器设置。
常见问题
为什么每次都要重新编译？
AI 改的是源码，HEX 不会自动更新。必须重新编译，烧录的才是最新代码。
可以只用 AI 不装 Keil 吗？
STC 本机编译需要 Keil C51。没有编译器时只能得到源码，无法得到可烧录的 HEX。