astyle是一个常用的开放源码工具。它可以方便的将程序代码格式化成自己想要的样式而不必人工修改。本来嘛,作为高等生物应该优先去做一些智慧的事情,而不是把时间消耗在机器可以完美完成的事情上。
想要立刻开始?请先去主页http://sourceforge.net/projects/astyle下载最新版本。可以选择二进制版本,也可以下载源码自行编译。总之得到可执行文件后请将astyle放在Path(C:\Program Files\Microsoft Visual Studio 8\Common7\IDE)中,这样会方便很多。
astyle是一个命令行工具,命令语法很简单:
astyle [options] < original > Beautified
astyle [options] Foo.cpp Bar.cpp [...]
例如:
astyle --style=ansi foo.cpp
上面的命令将美化foo.cpp文件,更改其风格为ANSI,并将原始文件备份到foo.cpp.orgin。所以,你可以安全的使用该软件而不必担心会将代码改得无法回头。
具体的来说,astyle包含了以下几种预定义风格,只需在参数中简单指定即可使用:
--style=ansi:ANSI 风格格式和缩进
namespace foospace
{
int Foo()
{
if (isBar)
{
bar();
return 1;
}
else
return 0;
}
}
--style=kr :Kernighan&Ritchie 风格格式和缩进
namespace foospace {
int Foo() {
if (isBar) {
bar();
return 1;
} else
return 0;
}
}
--style=linux :Linux 风格格式和缩进
namespace foospace
{
int Foo()
{
if (isBar) {
bar();
return 1;
} else
return 0;
}
}
--style=gnu :GNU 风格格式和缩进
namespace foospace
{
int Foo()
{
if (isBar)
{
bar();
return 1;
}
else
return 0;
}
}
--style=java :Java 风格格式和缩进
class foospace {
int Foo() {
if (isBar) {
bar();
return 1;
} else
return 0;
}
}
从这里开始介绍astyle的高级应用!这里要介绍的是两种应用情形,一是在Visual Studio中整合,二是批量处理。
先看如何在Visual Studio中整合。看图说话!
第一步:点击“工具”菜单
第二步:点击“外部工具”
第三步:配置并保存
在对话框中点击“添加”,如图填入各项。其中参数填写 --style=ansi $(ItemFileName)$(ItemExt)
可以勾选“使用输出窗口”,这样将不会显示黑色的命令窗口。相关信息都会显示在Visual Studio中。
经过上面设置之后,只需点击该菜单项就可以将当前文档格式化成ansi风格。如果你想要其它风格,可以自行设置参数。
值得注意的是在低版本的Visual Studio中,默认设置运行外部程序不会保存当前文档。这样的话如果在未保存的情况下运行该命令,未保存部分将会丢失。这个可以通过设置一个选项来解决。Visual Studio 6.0中:Options -> Editor -> Save Options -> Save before running tools 将该项勾选即可。我已经验证,在Visual Studio 2005中不用担心这类问题,可以放心使用。但是作为一个好习惯,我仍然建议你随时保存你的工作,尤其是做这种大幅度改动之前,甚至应该对源代码进行Check in操作。不知道Check in是什么?没关系,过几天我还会写一篇关于代码控制的文章,应该可以解决你的疑惑。
1.常用功能
(1) 单个文件--缺省美化
astyle --style=ansi Form1.cs
处理前的代码:
private void Form1_Load(object sender, EventArgs e)
{
int s;
for (int i=0;i<10;i++){
for (int j=0;j<10; j++){
s = s+j+i;}
}
}
处理后:
private void Form1_Load(object sender, EventArgs e)
{
int s;
for (int i=0;i<10;i++)
{
for (int j=0;j<10; j++)
{
s = s+j+i;
}
}
}
(2) 单个文件--更改缩进2个空格
astyle --style=ansi --indent=spaces=2 Form1.cs
缺省缩进一个TAB,也可以显式说明使用Tab,如下:
astyle --style=ansi --indent=tab Form1.cs
(3) 处理多个文件--有限个
astyle --style=ansi Form1.cs Form2.cs
(4) 批量处理多个文件--无限个
for /R .\ %f in (*.cs) do astyle --style=ansi "%f"
说明:/R表明遍历一个目录树,后面紧跟的路径是根,缺省为当前目录。
本例中,根为.\表示当前目录,命令等价于:
for /R %f in (*.cs) do astyle --style=ansi "%f"
作用是从(目录树根)当前目录开始,查找所有java文件,包含子目录中的文件;然后交给astyle处理。
当然,目录树根也可以使用绝对路径,下面的命令查找C盘所有的java文件并处理。
for /R c:\ %f in (*.cs) do astyle --style=ansi "%f"
2. 其他比较有用的开关:(均在--style之前写)
(1) -f
在两行不相关的代码之间插入空行,如import和public class之间、public class和成员之间等;
(2) -p
在操作符两边插入空格,如=、+、-等。
如:int a=10*60;
处理后变成int a = 10 * 60;
(3) -P
在括号两边插入空格。另,-d只在括号外面插入空格,-D只在里面插入。
如:MessageBox.Show ("aaa");
处理后变成MessageBox.Show ( "aaa" );
(4) -U
移除括号两边不必要的空格。
如:MessageBox.Show ( "aaa" );
处理后变成MessageBox.Show ("aaa");
(5) -V
将Tab替换为空格。
下面再介绍第二项独门绝技:批量格式化!
有时候你会有很多文件需要格式化成统一风格,难道一个个点击菜单?不!那样太累了。
在Windows中,我们可以用命令行来解决问题。这里用到一个超级命令 for
我来写个范例,大家就知道该怎么处理了。
for /R %f in (*.cpp;*.c;*.h) do astyle --style=ansi "%f"
该命令在当前目录中寻找文件名匹配模式 *.cpp;*.c;*.h 的所有文件(不同模式可用英文逗号隔开),并且对每个文件%f执行操作:
astyle --style=ansi "%f"
原帖地址:http://blog.csdn.net/memory_xj/archive/2008/09/26/2983093.aspx
AStyle(全称Artistic Style)是一个C、C++、C#和Java源代码缩进、格式化和美化工具。官方下载是命令行版程序,可以整合到开发IDE环境中去使用,甚至也可以整合到Notepad++之类的编辑器中。
官方地址:http://astyle.sourceforge.net/
本地下载:http://download.csdn.net/source/3323725
在这里介绍AStyle整合到VS2008的方法,以及如何使用。
1.首先下载AStyle,将其bin文件夹下的"AStyle.exe"解压到"D:/Program Files/Microsoft Visual Studio 9.0/Common7/Tools"文件夹下,具体路径根据所安装的VS路径进行更改,这是专门放置Visual Studio外部工具的文件夹;
2.打开Visual Studio 2008,在菜单栏→"工具"→"外部工具",点击"添加",在下面的编辑框里分别填入信息:
标题:AStyle格式化工具
命令:D:/Program Files/Microsoft Visual Studio 9.0/Common7/Tools/AStyle.exe
参数:-A1pNYk3 $(ItemFileName)$(ItemExt)
初始化目录:$(ItemDir)
√使用输出窗口
3.就可以在"工具"菜单栏下看到"AStyle格式化工具"选项了,要格式化文档前,先保存文档再调用"AStyle格式化工具"选项,这时,会弹出"是否要重新加载它"的询问框,可在"工具"→"选项"→"环境"→"文档"→"自动加载更改"打钩。
4.要为"AStyle格式化工具"选项设置快捷键的话,在"工具"菜单上选择"选项",从"环境"页中选择"键盘",在"显示命令包含"列表中键入"工具",在"命令名"列表中滚动到相应的"外部命令 n"项。在这里我是第9个外部命令项,所以找到"工具.外部命令9",在"按快捷键"处,键入要设置的快捷键,点击"分配"。如下图所示:
AStyle参数如下:
①Ansi/Allman/Bsd风格(格式缩进从下一行开始括号)
int Foo(bool isBar) { if (isBar) { bar(); return 1; } else return 0; } |
②Java风格(格式缩进直接紧接后面括号)
int Foo(bool isBar) { if (isBar) { bar(); return 1; } else return 0; } |
③Kernighan_Ritchie风格(格式缩进使用Linux方式括号)
int Foo(bool isBar) { if (isBar) { bar(); return 1; } else return 0; } |
④Stroustrup风格(格式缩进使用stroustrup方式括号,缩进使用5个空格)
int Foo(bool isBar) { if (isBar) { bar(); return 1; } else return 0; } |
⑤Whitesmith风格(格式缩进使用下一行且缩进的括号)
int Foo(bool isBar) { if (isBar) { bar(); return 1; } else return 0; } |
⑥Banner风格(格式缩进使用直接紧接和缩进的括号)
int Foo(bool isBar) { if (isBar) { bar(); return 1; } else return 0; } |
⑦GNU风格(格式缩进使用下一行括号,语句块括号缩进两个空格)
int Foo(bool isBar) { if (isBar) { bar(); return 1; } else return 0; } |
⑧Linux风格(格式缩进使用Linux方式括号,语句块里面缩进8个空格)
int Foo(bool isBar) { if (isBar) { bar(); return 1; } else return 0; } |
⑨Horstmann风格(格式缩进使用horstman方式,括号紧接语句块)
int Foo(bool isBar) { if (isBar) { bar(); return 1; } else return 0; } |
⑩1tbs/otbs风格(格式缩进使用Linux方式括号,自动补全单行语句块括号)
int Foo(bool isBar) { if (isBar) { bar(); return 1; } else { return 0; } } |
⑾pico风格
int Foo(bool isBar) { if (isBar) { bar(); return 1; } else return 0; } |
⑿lisp/python风格
int Foo(bool isBar) { if (isBar) { bar() return 1; } else return 0; } |
也可以自定义格式化参数:
①制表和括号选项
参数命令 | 参数说明 |
default indent option | 默认4个空格 |
--indent=spaces / --indent=spaces=# / -s# | 指定#个空格,#在1~20之间 |
--indent=tab / --indent=tab=# / -t# | 使用制表符,指定#个空格(1~20) |
--indent=force-tab / --indent=force-tab=# / -T# | 强制使用制表符,指定#个空格,#在1~20之间 |
default brackets option | 默认不改变括号 |
--brackets=break / -b | 括号改为下行( e.g. ANSI C / C++ style ) |
--brackets=attach / -a | 括号在语句后( e.g. Java / K&R style ) |
--brackets=linux / -l | 括号如linux风格 |
--brackets=stroustrup / -u | 括号如stroustrup风格 |
--brackets=horstmann / -g | 括号如horstmann 风格 |
②缩进选项
参数命令 | 参数说明 |
--indent-classes / -C | 缩进class和struct块后面的public等 |
--indent-switches / -S | 缩进switch块后面的case块 |
--indent-cases / -K | 缩进case块后面的括号 |
--indent-brackets / -B | 括号缩进 |
--indent-blocks / -G | 括号缩进,函数缩进 |
--indent-namespaces / -N | 命名空间后缩进 |
--indent-labels / -L | 额外的标签缩进 |
--indent-preprocessor / -w | 多行反斜杠定义缩进 |
--indent-col1-comments / -Y | 允许注释跟随代码一起缩进 |
--max-instatement-indent=# / -M# | 在连续声明中缩进最大#个空格(#小于80,默认为40) |
--min-conditional-indent=# / -m# | 在多行中设置最小缩进(#小于40,默认为当前两倍缩进) |
③填充选项
参数命令 | 参数说明 |
--break-blocks / -f | 在循环语句前后加空行 |
--break-blocks=all / -F | 在循环语句前后、else、catch前加空行 |
--pad-oper / -p | 运算符前后加空格 |
--pad-paren / -P | 在括号内外都加上空格 |
--pad-paren-out / -d | 在括号外加上空格 |
--pad-paren-in / -D | 在括号内加上空格 |
--pad-header / -H | 只在括弧头部添加一个空格 |
--unpad-paren / -U | 移除括号内外的空格 |
--delete-empty-lines / -x | 删除函数方法里多余的空行 |
--fill-empty-lines / -E | 以空格对齐填充前一行空行 |
④格式化选项
参数命令 | 参数说明 |
--break-closing-brackets / -y | 让else语句块下起一行 |
--break-elseifs / -e | 让else if 语句拆开缩进 |
--add-brackets / -j | 自动补充括号,默认在条件语句后紧接括号 |
--add-one-line-brackets / -J | 自动补充括号,并且保持括号与语句在一行 |
--keep-one-line-statements / -o | 维持一行里的多条语句不变 |
--keep-one-line-blocks / -O | 不破坏一行里面的块 |
--convert-tabs / -c | 转换TAB 为空格 |
--align-pointer=type / -k1 --align-pointer=middle / -k2 --align-pointer=name / -k3 |
使指针或者引用符靠近变量类型 使指针或者引用符在变量类型和变量名称中间 使指针或者引用符靠近变量名称 |
--mode=c --mode=cs --mode=java |
指定为C/C++代码格式化 指定为C#代码格式化 指定为JAVA 代码格式化 |