VScode使用clang format文档自动代码格式化(C语言)
1、格式化之前的准备。
可以用Clang-Format插件,也可以用C/C++插件。因为现在的C/C++插件已经具备了这个功能。
2、配置相关
或者在setting.json中粘贴下面的代码,需要将C_Cpp.clang_format_path换成自己的clang-format路径。
{
"files.associations": {
"slider.h": "c"
},
"C_Cpp.clang_format_path": "C:\Users\Ruby\.vscode\extensions\ms-vscode.cpptools-1.14.4-win32-x64\LLVM\bin\clang-format.exe",
"C_Cpp.formatting": "clangFormat",
"C_Cpp.clang_format_fallbackStyle": "Visual Studio",
"C_Cpp.clang_format_sortIncludes": null,
"C_Cpp.clang_format_style": "file"
}
3、.clang-format文件
下面是我的配置:
---
Language: Cpp
#圆括号之后,多行内容,进行对齐
AlignAfterOpenBracket: Align
#连续赋值时,对齐所有等号
AlignConsecutiveAssignments: true
#连续声明时,对齐所有声明的变量名
AlignConsecutiveDeclarations: true
#连续宏定义时,对齐所有定义值
AlignConsecutiveMacros: AcrossEmptyLinesAndComments
#AlignOperands Align将对齐分割到多行上的单个表达式的操作数
AlignOperands: Align
#对齐连续的尾随的注释
AlignTrailingComments: true
#允许将一个函数声明的所有参数移到下一行.
AllowAllParametersOfDeclarationOnNextLine: false
#将简单的语句块放到一个单行
AllowShortBlocksOnASingleLine: false
#if (a) return;放单行 属性:Never、WithoutElse没有else的可以放单行、OnlyFirstIf只有第一个if放单行、AllIfsAndElse总是把简短的if, else if和else语句放在同一行。
AllowShortIfStatementsOnASingleLine: Never
#BinPackArguments:如果为false,函数调用的参数要么全部在同一行,要么各有一行。
BinPackArguments: false
#BinPackParameters:如果为false,函数声明或函数定义的参数将全部在同一行或各有一行。
BinPackParameters: false
BreakBeforeBraces: Custom
# 控制单独的大括号换行事件,只有当BreakBeforeBraces设置为Custom时才有效
BraceWrapping:
#使控制语句(if/for/while/switch/..)换行。
AfterControlStatement: true
#使枚举定义换行。
AfterEnum: true
#使函数定义换行。
AfterFunction: true
#使结构定义换行。
AfterStruct: true
#使共同体定义换行。
AfterUnion: true
#在else之前换行。
BeforeElse: true
#换行大括号缩进。
IndentBraces: false
#空函数是否可以放在单行:flase允许 true不允许
SplitEmptyFunction: true
#空类,结构或联合主体是否可以放在单行:flase允许 true不允许
SplitEmptyRecord: true
#空namespace是否可以放在单行:flase允许 true不允许
SplitEmptyNamespace: true
SpaceBeforeParens: Custom
#控制圆括号前的单独空格,只有当SpaceBeforeParens设置为Custom时才有效
SpaceBeforeParensOptions:
#在控制语句关键字(for/if/while…)和开括号之间放置空格
AfterControlStatements: true
#在函数声明名称和开括号之间不允许使用空格
AfterFunctionDeclarationName: false
#指针对齐:右
PointerAlignment: Right
# 三元运算符将被放置在换行后
BreakBeforeTernaryOperators: true
#每行字符的限制,0表示没有限制
ColumnLimit: 0
#缩进空格宽度:4
IndentWidth: 4
#保留在赋值操作符之前的空格
SpaceBeforeAssignmentOperators: true
#不要排序include的头文件
SortIncludes: Never
#允许重新排版注释
ReflowComments: true
#尾行注释前的空格数
SpacesBeforeTrailingComments: 2
#连续空行的最大数量
MaxEmptyLinesToKeep: 1
#使用tab字符: Never从不使用, ForIndentation仅在缩进时使用制表符, ForContinuationAndIndentation, Always
UseTab: Never
#SpacesInParentheses如果为真(true), 将会在“(”之后和“)”之前插入空格。
SpacesInParentheses: false
#SpacesInSquareBrackets如果为真(true),将会在“[”之后和“]”之前插入空格。
SpacesInSquareBrackets: false
ps:网上我看很多人提到这个.clang-format文件不能有中文,但是目前在我这是没问题的,不知道其他人有没有影响。
4、在文件中右键,格式化文档即可。
5、勾选下面的设置,可以在每次保存之前自动格式化代码,快捷键是Shift+Alt+f。
---------------------2023.07.19更新---------------------------
[注: 这里格式化的范围是当前保存文件。 如果想批量格式化文件夹,安装 format files 插件安装,选中想格式化的文件夹,右键开始格式化即可。 ]