Xcode中的Re-Indent,顾名思义,只是一个调整缩进的功能,完全依赖它来进行代码格式化显然不够用。我们使用了一个叫做ClangFormat-Xcode的插件,配合Re-Indent一起来做代码格式化。
下载源代码
ClangFormat-Xcode是一个开源项目,所以先下载源代码:
安装
项目的README.md上面如是说:
... build and run ClangFormat, restart Xcode.
意思就是:编译 > 运行 > 重启Xcode
使用自定义Style
如何使用,包括怎么设置快捷键,github上面写得很清楚了。这里讲一下怎么使用自定义Style:
- 在代码根目录下添加一个名为“.clang-format”的文本文件,在其中设置自定义参数。
- 在对代码文件进行格式化的时候,插件会从代码文件所在的目录开始,往上一级一级地检索.clang-format,因此把文件放在根目录是最省事的做法;
- 在ClangFormat-Xcode源代码的根目录下就有一个.clang-format文件的范例;
- .clang-format在系统中是一个隐藏文件。
- 在Xcode的Clang Format菜单中勾选“File”菜单项。
推荐参数
下面是我们项目在用的设置参数,用文本编辑器打开.clang-format文件,直接粘贴进去就行:
BasedOnStyle: LLVM
# 不限定每行代码的最大长度
ColumnLimit: 0# 不自动清除代码中的空行
MaxEmptyLinesToKeep: 99# 按照LLVM Style调整{}的位置即可
# LLVM Style对C++的命名空间不缩进
# 对C++的可见性关键字(public、protected和private)不缩进
AccessModifierOffset: -4# 缩进统一使用4个空格代替制表符(Tab)
UseTab: Never
IndentWidth: 4# 在@property后加空格
ObjCSpaceAfterProperty: true# LLVM Style会在参数类型和名称之间加空格,类型和*号之间加空格,*号贴近参数名
以上参数的主要作用是:
1、排版风格以“LLVM Style”为基础,在其之上进行细微调整,减少设置的复杂度;
2、关闭掉一些可能会降低代码可读性的设置,比如:
- 不限定每行代码的最大长度,以免因为自动换行而破坏注释的排版;
- 不自动清除代码中的空行,以免破坏代码的段落布局。
3、调整{}的位置;
4、调整缩进,比如:
- 对C++的命名空间不缩进;
- 对C++的可见性关键字(public、protected和private)不缩进;
- 缩进统一使用4个空格代替制表符(Tab)。
5、调整空格,比如:
- 清理行末位多余的空格;
- 在@property后加空格;
- 参数类型和名称之间的空格。
其他一些经验技巧
最后分享一下我们在使用Clang Format过程中的一些经验技巧:
- 对于接口文件(.h文件),用上面的推荐参数格式化即可;
- 对于实现的代码(.m和.mm文件),可以先用推荐参数格式化,再用Xcode的Re-Index调整缩进;
- 完美!