1. 改个工程名,为什么 hex 和 bin 会对不上:Keil MDK5 的三套名字
在 Keil MDK5 里改工程名,是很多嵌入式开发都干过的事:复制一份工程当新分支,打开 Manage Project Items 把名字一改,编译零错误,下载器一跑,板子上的行为却还是旧逻辑。翻车点通常不在代码,而在 mdk 把“工程名”拆成了三套东西:磁盘上的工程文件名、Manage Project Items 里的 Target 名、Output 选项卡里的 Name of Executable。改其中任何一个,另外两个不会自动跟着走。这篇就围绕改工程名和生成 hex/bin 这条线,把三个名字的关系、Output 选项卡怎么填、产物到底落在哪讲清楚。适合接手别人工程、要给产线出 hex、或者刚用 Keil MDK5 不久的人照着做。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 拆开 Keil MDK5 的三套名字:工程文件、Target 与 Name of Executable
2.1 Manage Project Items 里改的是 Target,不是工程文件
点击 Keil MDK5 工具栏上那个三个方块的图标,会打开 Manage Project Items 对话框。左侧是 Project Targets 列表,右侧是 Groups 和文件列表。很多人在这里选中旧名字,直接改成新名字,回车,点 OK,就以为“工程改名完成了”。实际上这里改的是 Target 名,不是磁盘上的 .uvprojx 工程文件名。
Target 是编译目标,一个工程里可以挂多个 Target,比如一个用于调试、一个用于发布,每个 Target 可以有自己的宏定义、包含路径和 Output 配置。改 Target 名只是给这套编译配置换了个标签,它不会去动文件夹里的工程文件,也不会自动把输出文件名一起改掉。这就是为什么有人改完 Target 名,编译日志里一切正常,但去目录里一看,工程文件还叫旧名字,下载器配置里写的也还是旧 hex。
我一般会先看工具栏上的 Target 下拉框,确认当前选中的到底是哪一个 Target,再去 Manage Project Items 里改。改完以后再看一眼下拉框,确保当前激活的是新名字,而不是工程里另一个没改的 Target。这个动作很小,但能避免“改是改了,编译的还是另一套配置”的尴尬。
2.2 Name of Executable 决定 hex 和 bin 的文件名
点魔法棒打开 Options for Target,切到 Output 选项卡,里面有一项 Name of Executable。它控制的是编译输出可执行文件的基础名,hex 和 bin 的文件名都跟着它走。默认情况下它通常与 Target 同名,但不要假设改了 Target 它一定同步;改完 Target 后回到 Output 页确认一遍,是更稳的做法。
如果 Name of Executable 里还留着旧名字,你在 build 目录里找到的 hex 就会叫旧名。下载器里配置的是新名,路径一拼,自然对不上。更隐蔽的情况是:名字对了,但输出目录没改,hex 落在旧目录里,下载器去新目录找,同样找不到。名字和目录要分开看,不能混成一个“我明明改了啊”的问题。
Name of Executable 里不要带空格、中文和特殊符号,用字母、数字、下划线就够了。有些下载器对文件名里的空格处理得很随意,路径一长就容易出玄学问题。这不是 Keil MDK5 本身的要求,而是后面工具链的脾气,提前避开能省很多事。
2.3 一张表看清三个名字各自管什么
把三个名字放在一张表里,改名前后的影响范围会清楚很多:
| 名字或配置 | 在哪看 | 控制什么 | 只改它的后果 |
|---|---|---|---|
工程文件名 .uvprojx |
文件管理器 | 打开哪个工程、工程文件本身 | 文件夹里新旧工程并存,容易打开错 |
| Target 名 | Manage Project Items | 当前编译配置、宏和包含路径的归属 | 编译的可能是另一套配置 |
| Name of Executable | 魔法棒 Output 选项卡 | hex 和 bin 的文件基础名 | 产物名字与下载器配置不一致 |
| 输出目录 | 魔法棒 Output 选项卡 | hex 等产物的落点 | 去工程根目录找 hex 找不到 |
这张表里最容易被忽略的是最后一行。Output 选项卡除了 Name of Executable,还有输出目录的选择。材料里提到的默认情况是:bin 落在工程根目录,hex 则可以在 build 目录生成。也就是说,bin 和 hex 的路径规则本来就不一样,改名字时如果只盯着其中一个,另一个很容易留在旧位置。
3. 从 Manage Project Items 到 Create Hex File:一次改名的完整操作
3.1 先改工程文件名,再改 Target 名
改工程名不要一上来就点 Manage Project Items。先把 Keil 里的工程关掉,整个工程目录备份一份,然后在文件管理器里改工程文件名。顺序反过来,容易出现“Keil 还开着旧工程,磁盘上的文件已经被改名”的情况,后面再打开就找不到原来的引用。
bash复制# 先备份整个工程目录,再改工程文件名
cp -r demo_v1 demo_v2
# 进入新目录,把旧工程文件改成新名字
mv demo_v1.uvprojx demo_v2.uvprojx
cp -r 的 -r 是递归复制,工程目录里的子目录和文件都会带过去;mv 在这里做重命名,把旧工程文件改成新名字。改完后再双击新的 .uvprojx 打开工程,不要直接在旧工程窗口里操作。打开后检查工具栏 Target 下拉框,确认当前选中的是哪个 Target,再点三个方块图标进入 Manage Project Items,在 Project Targets 列表里把旧 Target 名改成新名字,回车确认,点 OK。
这一步完成后,磁盘上的工程文件名和 Target 名已经对齐了,但输出文件名还不一定。很多人在这里就直接编译,结果 hex 还是旧名,因为 Output 选项卡里的 Name of Executable 没动。改 Target 名不会自动帮你把输出名改掉,这一点要记牢。
3.2 Output 选项卡里勾选 Create Hex File 并核对名字
接下来点魔法棒打开 Options for Target,切到 Output 选项卡。这里要做三件事:确认 Name of Executable 是新名字,勾选 Create Hex File,按需要把输出目录指到 build。材料里给出的路径是“点击魔法棒 -> Output 选项卡 -> 勾选 Create Hex File -> 填写 Name of Executable”,如果希望 hex 落在 build 目录,还要先把输出目录配到 build。
| 配置项 | 建议值 | 作用 |
|---|---|---|
| Name of Executable | 与工程同名,字母数字下划线 | 决定 hex 和 bin 的文件基础名 |
| Create Hex File | 勾选 | 编译时额外生成 hex |
| 输出目录 | 按需指到 build | 决定 hex 落在哪个目录 |
勾选 Create Hex File 之后,不要急着点 OK 去编译。先看 Name of Executable 是否为空,是否还带着旧工程名,是否混进了空格或中文。名字有问题时,编译不一定报错,但产物名字会和你预期不一样。输出目录也要看一眼,如果上一任工程把输出目录指到了某个旧 build 路径,你改完名字后 hex 仍然会落在旧路径里。
3.3 编译后按目录核对 bin 与 hex
配置完成后执行 Rebuild,不要只点 Build。增量编译有时会认为工程没有实质变化,链接步骤不重新跑,hex 的生成就可能被跳过。Rebuild 会清掉中间产物重新编译,虽然慢一点,但改名字之后值得走一遍。
编译完成后,按下面的目录结构核对产物:
bash复制# 编译完成后,按这个顺序找产物
project/
├── demo_v2.uvprojx # 工程文件
├── demo_v2.bin # 默认落在工程根目录的 bin
└── build/
└── demo_v2.hex # 勾选 Create Hex File 后落在输出目录
先看工程根目录有没有新的 bin,名字是否与 Name of Executable 一致;再去 build 目录看 hex 是否生成,文件名是否同样是新名字。如果 bin 在、hex 不在,先回 Output 选项卡看 Create Hex File 有没有真的勾上;如果 hex 在、名字是旧的,回 Name of Executable 改;如果两个都不在,先看编译日志里链接步骤有没有真正执行。
4. bin 在根目录、hex 在 build:Keil MDK5 输出路径怎么配
4.1 bin 与 hex 不是同一种产物
bin 和 hex 经常被当成“同一个东西的两种叫法”,但在下载和烧录环节,它们的差别很实际:
| 对比项 | bin | hex |
|---|---|---|
| 内容形式 | 纯二进制机器码 | 带地址信息的文本记录 |
| 生成方式 | 按工程配置输出 | 勾选 Create Hex File 后生成 |
| 常见落点 | 工程根目录 | Output 配置的输出目录,如 build |
| 下载器要求 | 通常需要手动指定起始地址 | 按文件内地址信息解析 |
| 适用场景 | 批量烧录、打包分发 | 仿真器或下载器直接烧写 |
把 bin 当 hex 交给下载器,或者把 hex 当 bin 塞进只认二进制的工具,都会出现“文件明明生成了,下载器就是不认”的情况。名字一样不代表格式一样,路径一样也不代表格式一样。改工程名时,先确定你要的是 bin 还是 hex,再去看对应的生成开关和落点。
4.2 输出目录决定 hex 落在哪
Output 选项卡里的输出目录,控制的是编译中间文件和 hex 等产物的落点。材料里的默认情况是 bin 落在工程根目录,而 hex 可以在 build 目录生成。这意味着你不能用“去根目录找 hex”的习惯去判断 hex 有没有生成。
找 hex 的顺序应该是:先看 Output 选项卡里输出目录配的是哪里,再去那个目录找;如果那里没有,再回工程根目录看是不是输出目录压根没改。找 bin 的顺序反过来:先看工程根目录,再看输出目录。两条路径分开查,才不会把“路径不对”误判成“没有生成”。
4.3 Name of Executable 与输出目录的三种组合
把 Name of Executable 和输出目录放在一起看,常见的组合有三种:
| Name of Executable | 输出目录 | 结果 |
|---|---|---|
| 旧名 | build | build 下生成旧名 hex,下载器找新名就失败 |
| 新名 | 默认 | 根目录生成新名 bin,输出目录生成新名 hex |
| 新名 | build | build 下生成新名 hex,根目录生成新名 bin |
第一种最坑:Target 改了,工程文件名也改了,唯独 Name of Executable 没改,build 目录里躺着旧名 hex。下载器配置的是新名,路径拼出来是空的,现场看起来就像“hex 没生成”。第二种和第三种的区别只在 hex 的落点,名字对了,路径也要对。改完名字后按这张表对一遍,比反复编译有效。
5. 改名后的常见翻车:五条现象、原因与处理
5.1 现象一:编译通过,烧录后还是旧逻辑
现象很典型:Rebuild 零错误,下载器也提示烧录成功,板子跑起来还是旧行为。原因通常不是编译没生效,而是下载器指向了旧 hex。改工程名时,新 hex 可能落在 build 目录,旧 hex 还留在根目录或旧输出目录,下载器配置里保存的是旧路径。路径没变,文件名没变,下载器就继续烧旧文件。
处理方式是先打开下载器的文件配置,确认它指向的 hex 完整路径,再和 Output 选项卡里的输出目录、Name of Executable 对一遍。对不上就以新路径为准改下载器配置。改完后把旧目录里的旧 hex 挪走或删掉,避免下次又选错。血泪经验是:改完名字第一次烧录,不要只看“下载成功”的提示,要看下载器状态栏里显示的文件名和路径。
5.2 现象二:Target 改了,hex 还是旧名字
Manage Project Items 里明明改了 Target 名,编译出来的 hex 还是旧名字。原因是 Target 名和 Name of Executable 是两套配置,改前者不会自动改后者。尤其从别人那里接手的工程,Output 选项卡里可能早就被填了一个固定名字,改 Target 根本不影响它。
解决方法是回到魔法棒的 Output 选项卡,直接看 Name of Executable 当前值,手动改成新名字,再 Rebuild。改完后去输出目录确认 hex 文件名,不要只看编译窗口的最后一句话。编译窗口通常只告诉你“生成了某个文件”,不会提醒你这个名字是不是你想要的。
5.3 现象三:勾了 Create Hex File 却找不到 hex
Create Hex File 勾上了,编译也过了,但在以为的目录里找不到 hex。原因有两个常见方向:一是输出目录不是你以为的那个目录,hex 落在 build 里,你却在根目录找;二是增量编译没有重新链接,hex 没有重新生成。前者是路径问题,后者是编译策略问题。
先按 Output 选项卡里的输出目录去找,找不到再回根目录找。还是没有就执行 Rebuild,强制重新链接。如果 Rebuild 之后仍然没有,检查 Name of Executable 是否为空或带了非法字符,名字异常时生成步骤可能被跳过。处理顺序是:看目录、看名字、再 Rebuild,不要一上来就怀疑 Keil 坏了。
5.4 现象四:复制工程后打开的是旧工程
把整个文件夹复制成新目录,改了 Target 名,结果双击打开的还是旧工程,或者两个工程窗口互相干扰。原因是磁盘上的 .uvprojx 文件名没改,快捷方式、最近打开列表、下载器配置都还指着旧文件。Target 名改了,工程文件名没改,文件夹里新旧两个工程看起来就像双胞胎。
处理方法是先在 Keil 里关闭工程,再到文件管理器把 .uvprojx 改成新名字,重新双击打开。改完后检查最近打开列表,确认打开的是新路径下的工程,不是旧路径。复制工程时最好连目录名一起改,别让新旧目录只差一个字符,后面排查路径问题时眼睛会看花。
5.5 现象五:hex 给了下载器,下载器不认
hex 文件确实生成了,名字和路径都对,下载器却提示格式不对或解析失败。常见原因是把 bin 当成了 hex,或者下载器里选的烧录格式与文件实际格式不一致。材料里 bin 默认落在工程根目录,hex 在 build 目录,两个文件长得很像,复制时很容易拿错。
解决方法是先确认扩展名,再确认下载器里的文件类型选项。hex 按带地址信息的格式解析,bin 通常要手动填起始地址。拿错文件时,改文件名没有用,必须换回正确格式的文件。我一般会在输出目录里只保留当前要用的那一个产物,或者给 hex 和 bin 分开放,减少手滑的概率。
6. 一套改名后的核对顺序:三查一重建
改名这件事,做完操作不等于做完验证。我习惯用“三查一重建”收尾:一查工程文件名,确认磁盘上的 .uvprojx 已经是新名字,最近打开列表没有指向旧路径;二查 Target 名,确认 Manage Project Items 里当前激活的 Target 是新名字,没有残留旧 Target;三查 Output 选项卡,确认 Name of Executable 是新名字、Create Hex File 已勾选、输出目录符合预期。三查完之后执行一次 Rebuild,再按路径找 bin 和 hex。
| 核对项 | 看哪里 | 通过标准 |
|---|---|---|
| 工程文件名 | 文件管理器 | .uvprojx 为新名字,旧工程已关闭 |
| Target 名 | Manage Project Items | 当前激活 Target 为新名字 |
| 输出文件名 | 魔法棒 Output | Name of Executable 为新名字 |
| hex 开关 | 魔法棒 Output | Create Hex File 已勾选 |
| 产物落点 | 工程根目录与 build | bin 和 hex 都能按预期路径找到 |
这套顺序不复杂,但能挡住大部分“改了但没完全改”的问题。从那以后我每次复制工程、改 Target 名之后,都强制走一遍:改工程文件名、改 Target、看 Output 的 Name of Executable、勾 Create Hex File、Rebuild、按路径找产物。希望帮到你。
