为何开发者偏爱将函数参数与左括号对齐?及重命名格式疑问
Google C++风格函数参数对齐:重命名后是否需要全盘格式化?
不需要为单个函数名修改就全盘格式化整个项目,建议遵循以下原则处理:
优先用自动化工具维护风格一致性
Google C++风格的参数对齐本质上不需要手动调整,应该依赖clang-format这类工具自动实现。配置好对应风格后,不管函数名是Foo还是FooBar,工具都会自动将换行后的参数调整到符合规范的缩进位置。比如用Google风格的clang-format配置,处理后的代码会是:void FooBar(int param1, int param2, int param3, int param4)完全不用手动计算缩进,从根源避免函数名长度变化导致的对齐问题。
局部修改,保持局部一致性
仅针对被重命名的FooBar函数调整参数格式,确保它和项目中同风格的其他函数保持一致即可,无需改动未涉及的代码。如果项目已有格式化工具,只需对当前修改的文件执行一次格式化命令;如果是手动调整,就把该函数的参数缩进统一到和其他函数相同的标准(比如固定4空格缩进,而非对齐到函数名后的括号)。若项目无自动化流程,可逐步推进规范
如果项目之前没有统一的格式化机制,没必要一次性全盘格式化(除非团队统一决策),可以借这次修改的机会,引入clang-format并配置Google风格,后续修改代码时顺便格式化对应文件,逐步实现全项目风格统一。
内容的提问来源于stack exchange,提问作者yanpengl
相关产品推荐
相关产品推荐

