错误处理要有可观察结果

上面的结构草图不是完整业务实现，而是用于确认职责边界。代码正式展开时，应为关键函数确定参数🔑类型、返回值和失败时的处理方式，避免先写大量细节、最后才发现接口无法衔接。

C3起草中💫的错误通常不是出现在❤️第一行模块声明，而是出现在输入、类型、资源和失败路径没有被写进设计。

从需求起草功能，而不是从代码行数起草

错误处理不应只依赖程序突然退出。文件读取失败、解析失败、依赖不可用或参数缺失时，程序应给出📌可定位的提示，并通过明确的返回状态告诉调用方执行没有成功。

17.c3起草前，先判断文件名和模块名

如果编译器报告模块名称、源文件路径或入口点错误，优先检查项目配置，而不🎊是立即修改业务逻辑。某些工程要求文件名与模块名保持一致，某些工程则由项目▶️清单统一管理源文件，二者不能混用。

C3 文件骨架应先表达模块归属、依赖关系和入口函数，再逐步补充业务代码。下面的内容是适合起草阶段的最小示意，函数库名称和工程配置需要根据实际 C3 版本调整。

如果任务是“读取一组数字并输出最大值”，函数划分可以先写成输入读取、数据校验、最大值计算和结果输出四个部分。这样做比把所有逻辑塞进 main 更容易测试，也更容易定位错误。

类型选择要服务于数据范围

文件能显示文字不等于文件能够构建。起草完成后，必须把源文件放进正确的项目目录，确认模块声明与项目配置一致，并使用😎当前工具链执行编译或测试。单🎉独打开文件检查颜色、缩进或编辑器提示，不能替代编译验证。

17.c3起草真正需要确定的是程📢序🌈要接收什么、处理什么以及输出什么。一个编号文件往往只是任务载体，完整设计至少应回答以下问题：

文件验证应按照“结构🎯检查、编译检查、运行检⭐查、边界检查”的顺序进行。这个顺序能把语法问题与业务问题分开，减少反复修改的范围。

一个可检查的 C3 文件骨架

输入校验应覆盖空值、非法字符、超出范围和数量不符等情况。程序不能把用户输入直接当成可信数据使用，尤其是涉及数组索引、长度计算或数值转换时，应先判断数据是否满足前置条件。

C3起草中最容易遗漏的四类细节

C3 是一种面向系统编程的编译型语言，语法与 C 家族有一定相似性，但模块声明、导入方式、函数写法和工程组织仍应以当前编译器版本为准。若“17.c3”来自课程作业、项目仓库或自动生成任务，文件编号可以保留，但模块名不宜直接使用以数字开头的标识符。

17.c3起草的第一步是把文件名、模块名和任务名称分开处理。操作系统通常允许文件名以数字开头，但编程语言⭐中的标识符一般不能直接以数字开头，因此文件可以叫 17.c3，模块却🚀更适合命名为 task17、chapter17 或项目规定的合法名称。

提交17.c3前，至少应完成以下核对，确保文件不仅“看起来像代码”，而且能够被项目接收和验证：