该脚本利用 Python 正则表达式匹配 C++ 数组初始化语句，提取元素并按指定宽度格式化输出，实现自动对齐。涉及文件读写、异常处理及字符串格式化技术，有效提升代码可读性与维护效率。
在维护 C++ 项目时，常遇到数组元素未对齐的情况，影响可读性。本文提供一个 Python 脚本，自动对齐 C++ 数组，并讲解代码原理与使用方法。
假设有这样的 C++ 数组：
AlarmInfoAreaA gstAlarmInfoAreaA[]={{0,0, MESSAGE_TYPE2B, SKUI_COLOR_COMMON_LIGHT_YELLOW, SKUI_COLOR_COMMON_NIGHT_YELLOW, MSG_NONE},{1,1, MESSAGE_TYPE2B, SKUI_COLOR_COMMON_LIGHT_YELLOW, SKUI_COLOR_COMMON_NIGHT_YELLOW, MSG_F_CAMERA_BLOCK},{,, MESSAGE_TYPE2B, SKUI_COLOR_COMMON_LIGHT_RED, SKUI_COLOR_COMMON_NIGHT_RED, MSG_PLS_BRAKE},
对齐后：
AlarmInfoAreaA gstAlarmInfoAreaA[]={{0,0, MESSAGE_TYPE2B, SKUI_COLOR_COMMON_LIGHT_YELLOW, SKUI_COLOR_COMMON_NIGHT_YELLOW, MSG_NONE},
{1,1, MESSAGE_TYPE2B, SKUI_COLOR_COMMON_LIGHT_YELLOW, SKUI_COLOR_COMMON_NIGHT_YELLOW, MSG_F_CAMERA_BLOCK},
{30,6, MESSAGE_TYPE2B, SKUI_COLOR_COMMON_LIGHT_RED, SKUI_COLOR_COMMON_NIGHT_RED, MSG_PLS_BRAKE},// ... 更多行};
# -*- coding: utf-8 -*-
import re
def align_array():
file_path = r'src\app\wins\MessageWindowConfig.cpp'
with open(file_path, 'r', encoding='utf-8') as f:
lines = f.readlines()
start_idx = None
end_idx = None
for i, line in enumerate(lines):
if 'AlarmInfoAreaA gstAlarmInfoAreaA[] = {' in line:
start_idx = i
if start_idx is not None and line.strip() == '};' and i > start_idx + 5:
end_idx = i
break
if start_idx is None or end_idx is None:
print('Array not found')
return
print(f'Found array: line {start_idx+1} to {end_idx+1}')
aligned_lines = []
for i in range(start_idx, end_idx + 1):
line = lines[i]
if '//' in line and '{' not in line:
aligned_lines.append(line)
continue
pattern = r'^\s*\{(\d+),\s*(\d+),\s*([^,]+),\s*([^,]+),\s*([^,]+),\s*([^}]+)\}\s*,?\s*$'
match = re.match(pattern, line.strip())
if match:
alarm_id = int(match.group(1))
icon_id = int(match.group(2))
msg_type = match.group(3).strip()
light_color = match.group(4).strip()
night_color = match.group(5).strip()
string_id = match.group(6).strip()
aligned = f' {{{alarm_id:4d}, {icon_id:4d}, {msg_type:16s}, {light_color:32s}, {night_color:33s}, {string_id}}},'
aligned_lines.append(aligned + '\n')
else:
aligned_lines.append(line)
new_lines = lines[:start_idx] + aligned_lines + lines[end_idx+1:]
with open(file_path, 'w', encoding='utf-8') as f:
f.writelines(new_lines)
print('Alignment completed!')
if __name__ == '__main__':
try:
align_array()
except Exception as e:
print(f'Error: {e}')
import traceback
traceback.print_exc()
# -*- coding: utf-8 -*-
import re
file_path = r'src\app\wins\MessageWindowConfig.cpp'
with open(file_path, 'r', encoding='utf-8') as f:
lines = f.readlines()
r''：原始字符串，反斜杠不转义with open()：上下文管理器，自动关闭文件'r'：只读模式encoding='utf-8'：UTF-8 编码readlines()：读取所有行，返回列表start_idx = None
end_idx = None
for i, line in enumerate(lines):
if 'AlarmInfoAreaA gstAlarmInfoAreaA[] = {' in line:
start_idx = i
if start_idx is not None and line.strip() == '};' and i > start_idx + 5:
end_idx = i
break
enumerate()：同时获取索引和内容start_idx};，记录 end_idx 并退出pattern = r'^\s*\{(\d+),\s*(\d+),\s*([^,]+),\s*([^,]+),\s*([^,]+),\s*([^}]+)\}\s*,?\s*$'
match = re.match(pattern, line.strip())
正则说明：
^\s*：行首空白\{：字面 {(\d+)：捕获数字（AlarmID）,\s*：逗号与空白([^,]+)：非逗号字符（Type、Color 等）([^}]+)：非 } 字符（StringID）\}\s*,?\s*$：} 后可选逗号，行尾if match:
alarm_id = int(match.group(1))
icon_id = int(match.group(2))
msg_type = match.group(3).strip()
light_color = match.group(4).strip()
night_color = match.group(5).strip()
string_id = match.group(6).strip()
aligned = f' {{{alarm_id:4d}, {icon_id:4d}, {msg_type:16s}, {light_color:32s}, {night_color:33s}, {string_id}}},'
aligned_lines.append(aligned + '\n')
match.group(1)：第 1 个捕获组int()：转为整数.strip()：去除首尾空白f'...'：f-string 格式化{变量：格式}：格式化输出
:4d：4 位整数，右对齐:16s：16 位字符串，左对齐{{{：输出单个 {（转义）new_lines = lines[:start_idx] + aligned_lines + lines[end_idx+1:]
with open(file_path, 'w', encoding='utf-8') as f:
f.writelines(new_lines)
lines[:start_idx]：数组前的行aligned_lines：对齐后的数组行lines[end_idx+1:]：数组后的行'w'：写入模式（覆盖）if __name__ == '__main__':
try:
align_array()
except Exception as e:
print(f'Error: {e}')
import traceback
traceback.print_exc()
if __name__ == '__main__':：直接运行脚本时执行try/except：异常处理traceback.print_exc()：打印完整错误堆栈将代码保存为 align_array.py，放在项目根目录。
修改第 5 行的文件路径：
file_path = r'你的文件路径\MessageWindowConfig.cpp'
python align_array.py
脚本会输出：
Found array: line 15 to 243
Alignment completed!
| 知识点 | 说明 | 示例 |
|---|---|---|
r'' | 原始字符串 | r'C:\Users\file.txt' |
with open() | 上下文管理器 | 自动关闭文件 |
enumerate() | 获取索引和值 | for i, line in enumerate(lines) |
re.match() | 正则匹配 | re.match(pattern, text) |
f'...' | f-string | f'Hello {name}' |
{变量：格式} | 格式化输出 | {num:4d} 表示 4 位整数 |
if __name__ == '__main__' | 主程序入口 | 直接运行脚本时执行 |
A: 使用绝对路径或相对路径，确保路径正确。
A: 确保文件是 UTF-8 编码，或修改 encoding 参数。
A: 检查数组格式是否与正则一致，可打印 line 调试。
A: 修改格式化字符串中的数字，如 {alarm_id:4d} 改为 {alarm_id:6d}。
该脚本实现了以下功能：
有助于提升代码可读性和维护效率。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online