如何用Python实现CFD专用输入文件的解析与正确性校验

核心结构适配前提 #

这类CFD输入文件是固定的「两行一组」结构：每组条目由1行带行首+标识的关键字行 + 1行紧随其后的独立参数取值行构成，无嵌套、无跨行交叉关联，非常适合逐行扫描做结构化解析。

基础解析流程搭建 #

• 逐行读取文件时，先统一清除每行首尾的空白字符，同时记录每行的原始行号，为后续报错定位做准备
• 构建全局规则字典，把所有程序原生支持的合法条目提前结构化存储：字典的键为标准关键字的完整字符串（比如+TURBULENCE MODEL、+PH VALUE, MODEL=），对应的值包含该关键字配套的参数校验规则、允许取值范围、格式要求
• 逐行识别行类型：
  • 带行首+的行归入待匹配的关键字候选
  • 非+开头的非空行，自动归入紧随前序关键字的参数候选
  • 遇到空行时不打断条目配对逻辑，仅做行内容跳过即可

两类校验需求的落地逻辑 #

行格式与关键字拼写校验 #

这部分覆盖所有结构类错误的识别：

• 行首标识校验：检查所有非空行的归属，禁止出现既不属于带+的关键字行、也不属于前序条目配套参数行的孤立行——比如错误示例里无+开头的PH VALUE, MODEL=2行，会直接被标记为「行首格式标识缺失」错误
• 关键字拼写校验：不做严格的字符串完全匹配，采用编辑距离做模糊匹配，把待识别的关键字和规则表内的所有标准关键字做距离计算，当距离小于2（即最多2个字符偏差）时，就判定为拼写偏差，比如TURVULENCE MODEL和标准的TURBULENCE MODEL仅差1个字符，会被精准识别为拼写错误
• 关键字行内部结构校验：严格比对标准关键字的固定结构，禁止把参数值直接写入关键字行，比如+PH VALUE, MODEL=的标准结构要求等号后不允许拼接内容，像错误示例里的PH VALUE, MODEL=2就会触发「参数赋值格式不规范」的错误

参数取值合规校验 #

完成条目配对（关键字行+对应参数行）后，自动调用规则字典内的对应校验逻辑做判断：

• 格式校验：比如湍流模型参数要求为固定长度的数字串，就校验参数行的字符长度、数据类型是否符合要求，像示例里的01222是5位纯数字，符合规则
• 取值范围校验：比如pH值要求为0-14的正整数，就解析参数行的数值，判断是否落在允许区间内，越界、非数字的内容都会被标记为参数错误

实用工程优化 #

• 所有校验错误附带行号、错误类型、具体问题描述，遇到拼写偏差时可以顺带给出正确的关键字写法提示
• 扫描过程中累计所有错误，最终一次性输出完整的错误清单，不要遇到第一个错误就终止扫描，提升用户的校验效率
• 解析完成后可以直接把配对完成的「关键字-参数」对转换成Python字典结构，方便后续对接CFD程序的调用逻辑

内容的提问来源于stack exchange，提问作者Julia Fischer