CC65项目中C128目标编译问题的分析与解决

问题背景

在使用CC65交叉编译器为Commodore 128(C128)开发程序时，开发者发现了一个有趣的现象：同样的源代码在Windows和Linux环境下编译后，在C128模拟器中的运行结果不同。Linux环境下编译的程序在C128上显示乱码，而Windows环境下编译的则能正常运行。

问题现象详细描述

开发者提供了一个简单的"Hello World"程序：

#include <stdio.h>
#include <c128.h>

void main()
{
    printf("Hello World!\n");
}

在Linux环境下使用以下命令编译：

~/git/cc65/bin/cc65 -t c128 hello.c
~/git/cc65/bin/cl65 term.s -o term.prg

结果在VICE C128模拟器中显示乱码，但在C64模式下运行正常。

而在Windows环境下通过Wine使用相同代码编译：

wine ~/work/code/cc65/bin/cc65.exe -t c128 term.c
wine ~/work/code/cc65/bin/cl65.exe term.s -o term.prg

结果在C128模拟器中正常运行，但在C64模式下无输出。

问题分析

经过深入分析，发现问题的根源在于编译过程中的目标平台指定不完整。虽然在使用cc65编译时指定了-t c128参数，但在使用cl65链接时没有再次指定目标平台。

CC65工具链的工作流程是分阶段的：

1. cc65负责将C代码编译为汇编代码
2. cl65负责将汇编代码链接为最终的可执行文件

关键点在于：每个阶段都需要明确指定目标平台。在Linux环境下，开发者只在编译阶段指定了c128目标，但在链接阶段没有指定，导致链接器默认使用了c64目标平台。

解决方案

正确的编译命令应该是：

cc65 -t c128 hello.c
cl65 -t c128 hello.s -o hello.prg

或者更简洁的单命令方式：

cl65 -t c128 hello.c -o hello.prg

技术细节

1. 目标平台继承性：CC65工具链中，编译和链接阶段的目标平台设置不会自动继承，必须分别指定。

2. 默认目标平台：当没有明确指定-t参数时，cl65会默认使用c64作为目标平台，这是为了保持与大量已有C64项目的兼容性。

3. C128特殊性：C128虽然包含C64模式，但其原生模式有显著差异：

   • 内存布局不同
   • I/O地址不同
   • 系统调用方式不同

4. 跨平台一致性：Windows和Linux版本的行为差异可能是由于环境变量或配置文件的不同导致的，但核心问题仍然是目标平台指定不完整。

最佳实践建议

1. 始终在cl65命令中明确指定目标平台，即使cc65阶段已经指定过。

2. 对于简单项目，推荐使用单命令编译链接方式，减少出错机会。

3. 在Makefile或构建脚本中，将目标平台定义为变量，确保所有阶段使用相同的设置。

4. 测试时，确保模拟器运行在正确的模式下（C128原生模式而非C64兼容模式）。

总结

这个案例展示了交叉编译工具链使用中的一个常见陷阱：多阶段构建过程中配置参数的不一致性。通过全面理解CC65工具链的工作机制，特别是编译和链接阶段的独立性，开发者可以避免类似问题，确保为特定目标平台正确生成可执行文件。