本软件适用于C, C++, C++/CLI, Objective‑C, C#, and Java
一、使用流程
1.安装软件
linux：apt install astyle，重启vscode
windows：下载最新版本，并将exe路径添加至PATH,重启vscode
2.安装vscode插件Astyle
3.配置
使用：设置->拓展->Astyle->在settings.json中编辑（后附具体配置）
配置示意图
"astyle.additional_languages": [
"c",
"cpp",
],
"astyle.cmd_options": [
"--style=allman",
"--indent=spaces=4",
"--indent-modifiers",
"--indent-switches",
"--indent-cases",
"--indent-namespaces",
"--indent-preproc-block",
"--min-conditional-indent=2",
"--pad-oper",
"--pad-header",
"--unpad-paren",
"--delete-empty-lines",
"--align-pointer=name",
"--align-reference=name",
"--keep-one-line-statements",
"--convert-tabs",
"--close-templates",
/*"--max-code-length=#", 单行code最大长度
"--break-after-logical",*/
"--suffix=none",
"--lineend=linux",
"--verbose",
],
"[c]": {
"editor.defaultFormatter": "chiehyu.vscode-astyle"
},
"[cpp]": {
"editor.defaultFormatter": "chiehyu.vscode-astyle"
},（配置参考：RT-thread）
具体配置：
1.大括号选项
--style=allman / --style=bsd / --style=break / -A1 ：分离大括号风格
int Foo(bool isBar)
{
if (isBar)
{
bar();
return 1;
}
else
return 0;
}--style=java / --style=attach / -A2 ：JAVA风格 ——附加大括号
int Foo(bool isBar) {
if (isBar) {
bar();
return 1;
} else
return 0;
}--style=kr / --style=k/r / -A3：Linux风格 —— 开始的大括号与名称空间、类和函数定义分开。其余大括号附加到函数内的所有其他内容，包括数组、结构体、枚举和语句。
int Foo(bool isBar)
{
if (isBar) {
bar();
return 1;
} else
return 0;
}--style=stroustrup / -A4：Stroustrup风格 —— 使用了linux大括号，并将大括号的结束头与结束头分开(例如:break - closing - headers)。开始的大括号只从函数定义中断开。开始的大括号附加到函数中的所有其他内容，包括名称空间、类、数组、结构、枚举和语句。这种样式经常与“attach - closing - while”、tab缩进和5个空格缩进一起使用。
int Foo(bool isBar)
{
if (isBar) {
bar();
return 1;
}
else
return 0;
}--style=whitesmith / -A5：白铁匠风格 —— 使用破碎的，缩进的括号。Switch块和类块缩进以防止以下case语句和c++类修饰符(public, private, protected)的“挂缩进”。
int Foo(bool isBar)
{
if (isBar)
{
bar();
return 1;
}
else
return 0;
}--style=ratliff / --style=banner / -A6：Ratliff风格 —— 使用附加的，缩进的括号。Switch块和类块缩进是为了防止下面的case语句和c++类修饰符(public, private, protected)出现“挂缩进”。
int Foo(bool isBar) {
if (isBar) {
bar();
return 1;
}
else
return 0;
}--style=gnu / -A7：GNU风格 —— 使用断括号。额外的缩进只被添加到函数内的块中。整个块都是缩进的，而不仅仅是大括号。这种样式经常用于缩进2个空格。
int Foo(bool isBar)
{
if (isBar)
{
bar();
return 1;
}
else
return 0;
}--style=linux / --style=knf / -A8：Linux风格 —— 使用Linux大括号。开始的大括号与名称空间、类和函数定义分开。大括号附加到函数内的所有其他内容，包括数组、结构体、枚举和语句。最小的条件缩进是一半缩进。如果您想要不同的最小条件缩进，请使用K&R样式。这种风格最适合大缩进。它经常与缩进8个空格一起使用。也称为内核范式(KNF)风格，这是在Linux BSD内核中使用的风格。
int Foo(bool isBar)
{
if (isFoo) {
bar();
return 1;
} else
return 0;
}--style=horstmann / --style=run-in / -A9：Horstmann风格 —— 使用破括号和插入语句。switch是缩进的，以允许在打开开关块上磨合。这种样式经常使用缩进3个空格。
int Foo(bool isBar)
{ if (isBar)
{ bar();
return 1;
}
else
return 0;
}--style=1tbs / --style=otbs / -A10：One True Brace 风格 —— 使用linux大括号，并将大括号添加到未加大括号的条件语句中。开始的大括号与名称空间、类和函数定义分开。大括号附加到函数内的所有其他内容，包括数组、结构体、枚举和语句。
int Foo(bool isBar)
{
if (isFoo) {
bar();
return 1;
} else {
return 0;
}
}--style=pico / -A11：Pico风格 —— 使用断开的大括号和带有附加的闭大括号的run-in语句。右大括号附加到代码块的最后一行。开关是缩进的，以允许在打开开关块上磨合。这种风格意味着保持一行块和保持一行语句。如果使用了add-大括号，它们将被添加为一行大括号。这种样式经常用于缩进2个空格。
int Foo(bool isBar)
{ if (isBar)
{ bar();
return 1; }
else
return 0; }--style=lisp / --style=python / -A12：Lisp风格 —— 使用附加的开括号和闭括号。右大括号附加到代码块的最后一行。这种风格意味着保持一行语句，而不是保持一行块。此样式不支持单行大括号。如果使用了add-one-line-大括号，它们将被添加为多行大括号。
int Foo(bool isBar) {
if (isBar) {
bar()
return 1; }
else
return 0; }--style=google / -A14： 谷歌风格 —— 使用附加的花括号和缩进的类访问修饰符。有关缩进修饰符格式的示例，请参阅缩进修饰符选项。这实际上不是唯一的大括号风格，而是带有非大括号变体的Java风格。这种样式经常用于缩进2个空格。
int Foo(bool isBar) {
if (isBar) {
bar();
return 1;
} else
return 0;
}--style=vtk / -A15：VTK(可视化工具包)风格 —— 使用破碎、缩进的大括号，除了类、数组、结构、枚举和函数定义的左大括号。Switch块缩进是为了防止下面的case语句出现“挂缩进”。
int Foo(bool isBar)
{
if (isBar)
{
bar();
return 1;
}
else
return 0;
}--style=mozilla / -A16：Mozilla风格 —— 使用linux大括号。开始的大括号与类、结构体、枚举和函数定义分开。大括号附加到函数中的所有其他内容，包括名称空间、数组和语句。这种样式经常与缩进2个空格和——break-return-type一起使用。
int Foo(bool isBar)
{
if (isBar) {
bar();
return 1;
} else
return 0;
}
2.Tab选项
default indent（如果没有设置缩进选项，将使用默认选项4个空格(eg：:-s4/--indent=spaces=4)。）
void Foo() {
....if (isBar1
............&& isBar2) // indent of this line can be changed with min-conditional-indent
........bar();
}--indent=spaces / --indent=spaces=# / -s#：每缩进使用#空格(eg：:-s3/--indent=spaces=3)。#必须在2到20之间。不指定同default indent
void Foo() {
...if (isBar1
.........&& isBar2) // indent of this line can be changed with min-conditional-indent
......bar();
}--indent=tab / --indent=tab=# / -t / -t#：使用制表符进行缩进，使用空格进行继续行对齐。这可以确保无论查看器的选项卡大小如何，代码都能正确显示。将每个缩进当作#空格(例如-t6 /——indent=tab=6)。#必须在2到20之间。如果没有设置#，将缩进处理为4个空格。
with indent=tab:
void Foo() {
> if (isBar1
> ........&& isBar2) // indent of this line can be changed with min-conditional-indent
> > bar();
}
with style=linux, indent=tab=8:
void Foo()
{
> if (isBar1
> ....&& isBar2) // indent of this line can NOT be changed with style=linux
> > bar();
}--indent=force-tab / --indent=force-tab=# / -T / -T#：如果可能的话，使用所有制表符缩进。如果连续行不是偶数个制表符，将在末尾添加空格。将每个制表符视为#空格(例如-T6 /——indent=force-tab=6)。#必须在2到20之间。如果没有设置#，将制表符视为4个空格。
with indent=force-tab:
void Foo() {
> if (isBar1
> > > && isBar2) // indent of this line can be changed with min-conditional-indent
> > bar();
}--indent=force-tab-x / --indent=force-tab-x=# / -xT / -xT#：这个force-tab选项允许将制表符长度设置为与缩进长度不同的长度。这可能会导致缩进同时包含制表符和空格。如果可能的话，制表符将用于缩进。如果不能使用制表符缩进，将使用空格代替。此选项设置制表符长度。将每个制表符视为#空格(例如-xT6 /——indent=force-tab-x=6。#必须在2到20之间。如果没有设置#，将制表符视为8个空格。为了改变缩进长度从默认的4空格选项"indent=force-tab"也必须使用。
with indent=force-tab-x (default tab length of 8 and default indent length of 4):
void Foo() {
....if (isBar1
> ....&& isBar2) // indent of this line can be changed with min-conditional-indent
> bar();
}
3.大括号修饰选项
--attach-namespaces / -xn：大括号总是附加在命名空间语句上。
namespace FooName {
...
}--attach-classes / -xc： 大括号总是附加在类语句上。
class FooClass {
...
};--attach-inlines / -xl：所有大括号都附加到类和结构的内联方法定义(仅c++)
class FooClass
{
void Foo() {
...
}
};--attach-extern-c / -xk：将大括号附加到带大括号的extern "C"语句(仅c++)
#ifdef __cplusplus
extern "C" {
#endif
但是函数定义是按照要求的大括号样式进行格式化的:
extern "C" EXPORT void STDCALL Foo()
{}--attach-closing-while / -xV：将'do-while'语句的'while'附加到右括号。这优先于大括号样式和break关闭大括号选项。
do
{
bar();
++x;
}
while x == 1;
becomes:
do
{
bar();
++x;
} while x == 1;
4.缩进选项
--indent-classes / -C：缩进'class'和'struct'访问修饰符'public:'， 'protected:'和'private:'(仅c++)
class Foo
{
public:
Foo();
virtual ~Foo();
};
becomes:
class Foo
{
public:
Foo();
virtual ~Foo();
};--indent-modifiers / -xG：缩进'class '和'struct'访问修饰符'public:'， 'protected:'和'private:'，缩进一半。如果与缩进类一起使用，这个选项将被忽略。(仅c++)
class Foo
{
public:
Foo();
virtual ~Foo();
};
becomes:
class Foo
{
public:
Foo();
virtual ~Foo();
};--indent-switches / -S：缩进'switch'块，以便'case X:'语句在switch块中缩进。整个case块是缩进的。
switch (foo)
{
case 1:
a += 1;
break;
case 2:
{
a += 2;
break;
}
}
becomes:
switch (foo)
{
case 1:
a += 1;
break;
case 2:
{
a += 2;
break;
}
}--indent-cases / -K：缩进'case X:'块从'case X:'头。不包含在块中的Case语句不缩进。
switch (foo)
{
case 1:
a += 1;
break;
case 2:
{
a += 2;
break;
}
}
becomes:
switch (foo)
{
case 1:
a += 1;
break;
case 2:
{
a += 2;
break;
}
}--indent-namespaces / -N：向名称空间块添加额外的缩进
namespace foospace
{
class Foo
{
public:
Foo();
virtual ~Foo();
};
}
becomes:
namespace foospace
{
class Foo
{
public:
Foo();
virtual ~Foo();
};
}--indent-after-parens / -xU：在包含开头圆括号'('或赋值'='的行后面缩进，包括函数定义、声明和返回语句。
void Foo(bool bar1,
bool bar2)
{
isLongFunction(bar1,
bar2);
isLongVariable = foo1
|| foo2;
}
becomes:
void Foo(bool bar1,
bool bar2)
{
isLongFunction(bar1,
bar2);
isLongVariable = foo1
|| foo2;
}--indent-continuation=# / -xt#：设置以开始的圆括号'('或赋值'='结尾的行的延续缩进，包括函数定义和声明。它还将修改前面的缩进后括号选项。#的值表示大量的缩进。有效值是从0到4的整数值。如果不使用该选项，则使用默认值1。
isLongVariable =
foo1 ||
foo2;
isLongFunction(
bar1,
bar2);
becomes (with indent-continuation=3):
isLongVariable =
foo1 ||
foo2;
isLongFunction(
bar1,
bar2);--indent-labels / -L：向标签添加额外的缩进，使它们显示比当前缩进少1个缩进，而不是向左刷新(默认)。
void Foo() {
while (isFoo) {
if (isFoo)
goto error;
...
error:
...
}}
becomes (with indented 'error:'):
void Foo() {
while (isFoo) {
if (isFoo)
goto error;
...
error:
...
}
}--indent-preproc-block / -xW：缩进预处理器块在大括号级别0，并立即在名称空间内。对缩进的内容有限制。方法、类、数组等中的块不会缩进。包含大括号或多行定义语句的块将不会缩进。没有此选项，预处理器块不会缩进。
#ifdef _WIN32
#include <windows.h>
#ifndef NO_EXPORT
#define EXPORT
#endif
#endif
becomes:
#ifdef _WIN32
#include <windows.h>
#ifndef NO_EXPORT
#define EXPORT
#endif
#endif--indent-preproc-define / -w：缩进以反斜杠结尾的多行预处理器定义。应该与 --convert-tabs一起使用，以获得正确的结果。做得很好，但不能在模糊预处理定义中执行奇迹。如果没有这个选项，预处理器语句将保持不变。
#define Is_Bar(arg,a,b) \
(Is_Foo((arg), (a)) \
|| Is_Foo((arg), (b)))
becomes:
#define Is_Bar(arg,a,b) \
(Is_Foo((arg), (a)) \
|| Is_Foo((arg), (b)))--indent-preproc-cond / -xw：将预处理条件语句缩进到与源代码相同的级别。
isFoo = true;
#ifdef UNICODE
text = wideBuff;
#else
text = buff;
#endif
becomes:
isFoo = true;
#ifdef UNICODE
text = wideBuff;
#else
text = buff;
#endif--indent-col1-comments / -Y：从第一列开始缩进c++注释。默认情况下，从第一列开始的c++注释被假定为注释输出代码，而不是缩进。此选项将允许注释与代码一起缩进。
void Foo()\n"
{// comment
if (isFoo)
bar();
}
becomes:
void Foo()\n"
{
// comment
if (isFoo)
bar();
}--min-conditional-indent=# / -m#：
设置header由多行组成时添加的最小缩进。这种缩进有助于轻松地将header与后面的命令语句分开。#的值表示缩进的数量，并且是最小值。缩进可能更大，以与前一行的数据对齐。有效值为:
0 - 没有最小缩进。这些行将与前一行上的括号对齐。
1 - 至少缩进一个额外的缩进。
2 - 缩进至少两个额外的缩进。
3 - 至少要增加定单的一半。这用于大缩进(例如8)。
默认值是2，两个额外的缩进。
// default setting makes this non-braced code clear
if (a < b
|| c > d)
foo++;
// but creates an exaggerated indent in this braced code
if (a < b
|| c > d)
{
foo++;
}
becomes (when setting --min-conditional-indent=0):
// setting makes this non-braced code less clear
if (a < b
|| c > d)
foo++;
// but makes this braced code clearer
if (a < b
|| c > d)
{
foo++;
}--max-continuation-indent=# / -M#：设置#空格的最大长度以缩进延续行。#表示列的数量，且不能小于40或大于120。如果没有设置，则使用默认值40。此选项将防止延续行向右延伸太远。设置更大的值将允许代码进一步向右扩展。
fooArray[] = { red,
green,
blue };
fooFunction(barArg1,
barArg2,
barArg3);
becomes (with larger value):
fooArray[] = { red,
green,
blue };
fooFunction(barArg1,
barArg2,
barArg3);
4.填充选项
--break-blocks / -f：在标题块周围填充空行(e.g. 'if', 'for', 'while'...).
isFoo = true;
if (isFoo) {
bar();
} else {
anotherBar();
}
isBar = false;
becomes:
isFoo = true;
if (isFoo) {
bar();
} else {
anotherBar();
}
isBar = false;--break-blocks=all / -F：在标题块周围填充空行(e.g. 'if', 'for', 'while'...).处理关闭头文件块(e.g. 'else', 'catch')作为独立块。
isFoo = true;
if (isFoo) {
bar();
} else {
anotherBar();
}
isBar = false;
becomes:
isFoo = true;
if (isFoo) {
bar();
} else {
anotherBar();
}
isBar = false;--pad-oper / -p：在运算符周围插入空格。这也会添加逗号。如果可能的话，行尾注释将保留在原始列中。注意，没有取消垫的选项。一旦被填充，它们就保持填充状态。
if (foo==2)
a=bar((b-c)*a,d--);
becomes:
if (foo == 2)
a = bar((b - c) * a, d--);--pad-comma / -xg：在逗号后插入空格。如果使用pad-oper，则不需要加。行尾注释将保留在原始列中。
if (isFoo(a,b))
bar(a,b);
becomes:
if (isFoo(a, b))
bar(a, b);--pad-paren / -P：在括号的外部和内部都插入空格填充。行尾注释将保留在原始列中。
if (isFoo((a+2), b))
bar(a, b);
becomes:
if ( isFoo ( ( a+2 ), b ) )
bar ( a, b );--pad-paren-out / -d：只在括号外面插入空格填充。空的括号不会加衬垫。如果可能的话，行尾注释将保留在原始列中。这可以用下面的unpad-paren来删除不需要的空间。
if (isFoo((a+2), b))
bar(a, b);
becomes:
if (isFoo ( (a+2), b) )
bar (a, b);--pad-first-paren-out / -xd：在序列的第一个圆括号周围只在外部插入空格填充。空的括号不会加衬垫。行尾注释将保留在原始列中。可以用unpad-paren删除不需要的空间。如果与pad‑paren或pad‑paren‑out一起使用，该选项将被忽略。
if (isFoo((a+2), b))
bar(a, b);
becomes:
if (isFoo ((a+2), b))
bar (a, b);--pad-paren-in / -D：只在里面插入圆括号周围的空格。行尾注释将保留在原始列中。这可以用下面的unpad-paren来删除不需要的空间。
if (isFoo((a+2), b))
bar(a, b);
becomes:
if ( isFoo( ( a+2 ), b ) )
bar( a, b );--pad-header / -H：在标题之间插入空格(e.g. 'if', 'for', 'while'...)和下面的括号。行尾注释将保留在原始列中。可以使用unpad-paren删除不需要的空格。
if(isFoo((a+2), b))
bar(a, b);
becomes:
if (isFoo((a+2), b))
bar(a, b);--unpad-paren / -U：在内外两边去掉多余的填充空间。行尾注释将保留在原始列中。
if ( isFoo( ( a+2 ), b ) )
bar ( a, b );
becomes (with no padding option requested):
if(isFoo((a+2), b))
bar(a, b);--delete-empty-lines / -xe：删除函数或方法中的空行。函数或方法之外的空行不会被删除。如果与break-blocks或break-blocks=all一起使用，它将删除除由break-blocks选项添加的行之外的所有行。
void Foo()
{
foo1 = 1;
foo2 = 2;
}
becomes:
void Foo()
{
foo1 = 1;
foo2 = 2;
}--fill-empty-lines / -E：用前一行的空白填充空行。
--align-pointer=type / -k1
--align-pointer=middle / -k2
--align-pointer=name / -k3
将指针或引用操作符(*、&或^)附加到变量类型(左)或变量名称(右)，或将其放在类型和名称(中间)之间。如果可能的话，将保留类型和名称之间的空格。这个选项适用于C/ c++、c++ /CLI和c#文件。要单独格式化引用，请使用以下align-reference选项。
char* foo1;
char & foo2;
string ^s1;
becomes (with align-pointer=type):
char* foo1;
char& foo2;
string^ s1;
char* foo1;
char & foo2;
string ^s1;
becomes (with align-pointer=middle):
char * foo1;
char & foo2;
string ^ s1;
char* foo1;
char & foo2;
string ^s1;
becomes (with align-pointer=name):
char *foo1;
char &foo2;
string ^s1;--align-reference=none / -W0
--align-reference=type / -W1
--align-reference=middle / -W2
--align-reference=name / -W3
该选项将引用与指针分开对齐。指针不会被这个选项改变。如果指针和引用要对齐，请使用前面的对齐指针选项。选项align-reference=none不会改变引用对齐方式。其他选项与对齐指针相同。(仅C/ C++、c++ /CLI和C#文件)。
char &foo1;
becomes (with align-reference=type):
char& foo1;
char& foo2;
becomes (with align-reference=middle):
char & foo2;
char& foo3;
becomes (with align-reference=name):
char &foo3;
5.格式化选项
--break-closing-braces / -y：当与 --style=java, --style=kr, --style=stroustrup, --style=linux, 或者--style=1tbs同时使用，会打破关闭头文件 (e.g. 'else', 'catch', ...) 。结束标题花括号总是与其他样式一起断开。
void Foo(bool isFoo) {
if (isFoo) {
bar();
} else {
anotherBar();
}}
becomes (a broken 'else'):
void Foo(bool isFoo) {
if (isFoo) {
bar();
}
else {
anotherBar();
}
}--break-elseifs / -e：将"else if"标题组合分隔成单独的行。如果使用keep-one-line语句，则此选项无效，“else if”语句将保持原样。
如果不使用此选项，"else If "标题组合将被放置在单行上。
if (isFoo) {
bar();
}
else if (isFoo1()) {
bar1();
}
else if (isFoo2()) {
bar2;
}
becomes:
if (isFoo) {
bar();
}
else
if (isFoo1()) {
bar1();
}
else
if (isFoo2()) {
bar2();
}--break-one-line-headers / -xb：从位于同一行的语句中断开一行标题(e.g. 'if', 'while', 'else', ...)如果语句用大括号括起来，大括号将根据要求的大括号样式进行格式化。如果使用keep-one-line-statements，则多语句行不会被断开。如果使用keep-one-line-blocks，并且报头包含在块中，则一行块不会被打断。
void Foo(bool isFoo)
{
if (isFoo1) bar1();
if (isFoo2) { bar2(); }}
becomes:
void Foo(bool isFoo)
{
if (isFoo1)
bar1();
if (isFoo2) {
bar2();
}
}--add-braces / -j：向不带大括号的单行条件语句添加大括号(例如:“如果”,“对”,“而”……)。大括号将根据要求的大括号样式添加。如果没有要求样式，将附加大括号。如果使用keep-one-line-statements，则不会将大括号添加到多语句行中。如果使用keep-one-line-blocks，则不会将大括号添加到一行块中。如果与--add-one-line-braces一起使用，结果将是一行大括号。
if (isFoo)
isFoo = false;
becomes:
if (isFoo) {
isFoo = false;
}--add-one-line-braces / -J：添加一行大括号到不加大括号的一行条件语句 (e.g. 'if', 'for', 'while'...)。该选项意味--keep-one-line-blocks，并且不会打破一行块。
if (isFoo)
isFoo = false;
becomes:
if (isFoo)
{ isFoo = false; }--remove-braces / -xj：从条件语句中删除括号(例如:“如果”,“对”,“而”……)。语句必须是单行上的单个语句。如果还使用--add-braces或--add-one-line-braces，结果将是添加大括号。大括号不会从"One True Brace Style"中删除，--style=1tbs。
if (isFoo)
{
isFoo = false;
}
becomes:
if (isFoo)
isFoo = false;--break-return-type / -xB
--break-return-type-decl / -xD
从函数名中分离返回类型。这两个选项用于函数定义(-xB)和函数声明或签名(-xD)。如与--attach-return-type一起使用，结果将破坏返回类型。
void Foo(bool isFoo);
becomes:
void
Foo(bool isFoo);--attach-return-type / -xf
--attach-return-type-decl / -xh
将返回类型附加到函数名。这两个选项用于函数定义(-xf)和函数声明或签名(-xh)。它们的目的是撤消--break-return-type选项。如果与--break-return-type一起使用，结果将打破返回类型。
void
Foo(bool isFoo);
becomes:
void Foo(bool isFoo);--keep-one-line-blocks / -O：不要打断一行代码块。
if (isFoo)
{ isFoo = false; cout << isFoo << endl; }
remains unchanged.--keep-one-line-statements / -o：不要打破复杂语句和驻留在一行中的多个语句。
if (isFoo)
{
isFoo = false; cout << isFoo << endl;
}
remains unchanged.--convert-tabs / -c：将Tab转换为行非缩进部分中的空格。插入的空格数将保持制表符的间距。使用每个选项卡的空格的当前设置。如果在更改每个选项卡的空格时使用convert-tabs，可能不会产生预期的结果。制表符不会在引号内替换。
--close-templates / -xy：关闭模板定义结束尖括号之间的空白。
Stack< int, List< int > > stack1;
becomes:
Stack< int, List< int >> stack1;--remove-comment-prefix / -xp：在以一行开头的多行注释中删除前面的'*'。如果末尾有'*'，也会被删除。小于一个缩进的文本缩进为一个缩进。不改变大于一个缩进的文本。一行开头没有'*'的多行注释被缩进为一个缩进，以保持一致性。这可以略微修改注释掉代码块的缩进。包含所有'*'的行保持不变。注释关闭符'*/'将删除额外的空格。
/*
* comment line 1
* comment line 2
*/
becomes:
/*
comment line 1
comment line 2
*/--max-code-length=# / -xC#
--break-after-logical / -xL
如果代码超过#字符，选项max‑code‑length将断行。有效值为50到200。没有逻辑条件的行会在逻辑条件(||，&&，…)、逗号、圆括号、分号或空格处中断。有些代码不会被破坏，比如注释、引号和数组。如果与keep‑one‑line‑blocks或add-one-line-braces一起使用，block不会被破坏。如果与keep‑one‑line‑statements一起使用，当行超过最大长度时，语句将以分号分隔。如果在最大代码长度内没有可用的断点，则该行将在最大代码长度之后的第一个可用断点处被中断。默认情况下，逻辑条件将放在新行的第一个位置。选项break‑after‑logical将导致逻辑条件被放在前一行的最后。如果没有最大代码长度，这个选项就不起作用。
if (thisVariable1 == thatVariable1 || thisVariable2 == thatVariable2 || thisVariable3 == thatVariable3)
bar();
becomes:
if (thisVariable1 == thatVariable1
|| thisVariable2 == thatVariable2
|| thisVariable3 == thatVariable3)
bar();
becomes (with break‑after‑logical):
if (thisVariable1 == thatVariable1 ||
thisVariable2 == thatVariable2 ||
thisVariable3 == thatVariable3)
bar();--mode=c
--mode=cs
--mode=java
缩进一个C类型、c#或Java文件。C类型文件有C、c++、c++ /CLI和Objective-C。该选项通常从每个文件的文件扩展名设置。您可以使用此条目覆盖该设置。它将用于所有文件，而不管文件扩展名是什么。它允许格式化程序识别特定于语言的语法，如c++类、模板和关键字。