文档介绍：（开发管理平台专项）
代码排版工具Uncrustify
使用说明
设备型号：
产品代号：
项目代号：
部门：
烽火通信科技股份有限公司宽带产品部
拟制：
王玮 2011 年 10 月 27 日
审核：
年月日
批准：
年月日
目录
1. 版本记录 2
2. 引言 3
. 背景说明 3
. 适用范围 3
. 执行标准 3
. 相关文档 3
. 参考资料 3
3. 代码排版工具使用说明 4
. Uncrustify简介 4
. 安装Uncrustify 4
. 配置Source Insight 4
. 配置Microsoft Visual Studio 5
. Uncrustify配置文件说明 6
. 软件编程规范排版要求的支持情况 7
4. 附录 Uncrustify参数说明 9
版本记录
序号
文件编号
生成时间
主要修改记录
作者
备注
1
2011-10-27
初次生成
王玮
初始化文档
引言
背景说明
委托部门：宽带产品部
项目名称：代码排版工具选型
项目说明：本项目为更好的落实宽带产品部《软件编程规范》中关于代码排版的要求，提高代码的可读性、排版的规范性，本着减少编程人员对代码排版的工作量、提高工作效率的原则，特以Uncrustify为基础开发了一款代码排版工具。该工具作为SourceInsight以及Microsoft Visual Studio 编辑器的插件，对C语言编写的代码进行排版。该工具排版之后的代码基本可满足部门《软件编程规范CHECKLIST》中所有排版类的要求。
适用范围
软件使用对象：宽带产品部软件开发人员
使用范围：宽带产品部产品软件研发过程
执行标准
序号
标准名称
版本号
发布单位
备注
01
M2009015-软件编程规范

宽带产品部
相关文档
序号
文档名称
版本号
作者
备注
01
M2009015-软件编程规范

向忠清
参考资料
序号
文档名称
版本号
作者
发表日期
出版单位/来源
备注
01
无
代码排版工具使用说明
Uncrustify简介
Uncrustify是一个代码美化工具可用于C,C++,C#,ObjectiveC,D,Java,Pawn和VALA源代码的美化。它能够利用空格，tab与空格或只有tab进行缩排,添加或删除换行,排列代码等，并且Uncrustify具有高配置性，易于修改的特点，可配合Source Insight及Microsoft Visual Studio进行使用。
安装Uncrustify
，解压缩路径以“c:\uncrustify”为例。
配置Source Insight
1 打开SourceInsight, 选择菜单“Options-->Custom Commands-->Add”, 输入uncrustify
2 Run中输入: C:\uncrustify\ -c C:\uncrustify\ –f %f –o %f
如果不想对源代码文件进行备份，可以输入：
C:\uncrustify\ -c C:\uncrustify\ --no-backup –f %f –o %f
3 Dir不填写，将“File,then Line”打上勾；
4 然后点对话框中右侧的按钮“Keys...”设置快捷键“Ctrl+F8”；
5 打开要格式化的文件，“Ctrl+F8”即可对当前文件格式化；
注1：C:\uncrustify\ -c C:\uncrustify\ –f %f –o %f命令中，-c表明需要调用配置文件，%f在Source Insight中代表当前文件，–o表示将排版后的输出直接替换当前文件（需要当前文件已经保存，否则Source Insight不会提示文件被外部编辑器改变，并重新载入）。
注2：%f –o %f也可以使用%s来替换，表明输入的是当前文件中所选择的部分，即uncrustify只对当前所选择的代码进行排版。如果要使用这种