Python正则替换含VERSION关键字C宏定义括号内数值的实现方案

需要通过Python+正则实现C头文件宏定义的定向替换，规则如下：

• 仅替换宏名包含VERSION关键字的宏定义行
• 替换目标为宏右侧括号内的数值/字母组合内容，默认替换为0，后续可扩展为从外部文件读取目标值
• 不含VERSION关键字的行完全保留原内容、原格式

待处理样例 #

#define CANIF_AR_RELEASE_MAJOR_VERSION     (999U)
#define CANIF_AR_RELEASE_MINOR_VERSION     (2U)
#define CANIF_AR_RELEASE_REVISION_VERSION  (2U)
#define TEST_CANTRCV_MODULE_ID             (70U)  /* 0x46 */

预期输出 #

#define CANIF_AR_RELEASE_MAJOR_VERSION     (0)
#define CANIF_AR_RELEASE_MINOR_VERSION     (0)
#define CANIF_AR_RELEASE_REVISION_VERSION  (0)
#define TEST_CANTRCV_MODULE_ID             (70U)  /* 0x46 */

原有代码问题 #

原有实现通过4次连续正则叠加替换，存在以下缺陷：

• 未做行级过滤，没有先判断行内是否包含VERSION关键字，极易误改非版本类宏
• 正则语法存在错误，例如[0-99]实际仅匹配0-9数字和字符9，无法覆盖多数字+后缀U的场景
• 多次替换链式执行，前序替换产生的格式错误会被后序逻辑放大，最终出现多余括号、错改字符等问题

核心思路是单次正则匹配+替换，通过捕获组保留所有不需要修改的内容（包括宏名、缩进空格、左括号），仅替换括号内的版本值，从根源避免格式错乱。

核心正则说明 #

正则表达式：r'(^#define\s+\w*VERSION\w*\s+\()\w+\)'
各部分含义：

• ^#define\s+：匹配行首的#define关键字+后续任意空白，开启re.M多行模式后按行匹配
• \w*VERSION\w*：匹配包含VERSION关键字的宏名，兼容宏名前后的其他标识符字符
• \s+\(：匹配宏名后到左括号之间的所有空白、左括号本身
• 以上内容整体作为第一个捕获组\g<1>，替换时完全保留，保证原格式空格不变
• \w+\)：匹配括号内的原有版本值（覆盖数字、字母后缀U的场景）+右括号，替换时将这部分替换为0)即可

基础版本代码（固定替换为0） #

import re

# 读取原文件
with open('McalLib_Cfg.h', 'r', encoding='utf-8') as f:
    content = f.read()

# 单次正则替换完成所有修改
pattern = re.compile(r'(^#define\s+\w*VERSION\w*\s+\()\w+\)', re.M)
new_content = pattern.sub(r'\g<1>0)', content)

# 写入新文件
with open('McalLib_Cfg1.h', 'w', encoding='utf-8') as f:
    f.write(new_content)

扩展版本（支持从外部文件读取版本值） #

假设外部版本配置文件version.txt格式如下：

MAJOR=1
MINOR=2
REVISION=3

可先读取配置生成映射关系，再定向替换对应版本宏，代码如下：

import re

# 第一步：读取外部版本配置
version_map = {}
with open('version.txt', 'r', encoding='utf-8') as f:
    for line in f:
        line = line.strip()
        if not line or '=' not in line:
            continue
        ver_type, ver_val = line.split('=', 1)
        version_map[ver_type.strip()] = ver_val.strip()

# 第二步：读取待处理头文件
with open('McalLib_Cfg.h', 'r', encoding='utf-8') as f:
    content = f.read()

# 第三步：按版本类型分别替换
for ver_type, ver_val in version_map.items():
    # 匹配对应类型的VERSION宏，比如MAJOR_VERSION、MINOR_VERSION
    pattern = re.compile(rf'(^#define\s+\w*{ver_type}_VERSION\s+\()\w+\)', re.M)
    content = pattern.sub(rf'\g<1>{ver_val})', content)

# 第四步：写入结果
with open('McalLib_Cfg1.h', 'w', encoding='utf-8') as f:
    f.write(content)

• 正则使用re.M多行模式，保证^可以匹配每一行的开头，不会跨行匹配误改内容
• 捕获组完整保留原行的空格、缩进，替换后格式和原文件完全一致
• 扩展版本可根据实际外部配置文件的格式调整读取逻辑，不需要修改核心替换正则

内容的提问来源于stack exchange，提问作者Lakshmi Srikanta