--- title: "样板 - 开发程序 - MetaEditor 帮助" description: "样板能很快将源代码布局按照建议标准保持一致。 这令代码看起来专业且易于阅读。 设计良好的代码在未来对作者和其他用户来说更容易分析。 若要启动样板，请单击 位于 工具 菜单里的样板，或按 Ctrl+,。 在样板中提供以下动作类型以便正确格式化代码... - 样板 - 开发程序 - MetaEditor 帮助" image: "https://www.metatrader5.com/i/logo_metatrader5.png" url: "https://www.metatrader5.com/zh/metaeditor/help/development/styler" --- [MetaEditor 帮助](https://www.metatrader5.com/zh/metaeditor/help) → [开发程序](https://www.metatrader5.com/zh/metaeditor/help/development) → 样板 # 样板 样板能很快将源代码布局按照建议标准保持一致。 这令代码看起来专业且易于阅读。 设计良好的代码在未来对作者和其他用户来说更容易分析。 若要启动样板，请单击![样板](https://www.metatrader5.com/i/help/metaeditor/en/styler_icon.png) 位于 [工具](https://www.metatrader5.com/zh/metaeditor/help/main_menu/main_menu_tools) 菜单里的样板，或按 Ctrl+,。 > 样板所做的代码布局更改可以撤消。 点击![撤销](https://www.metatrader5.com/i/help/metaeditor/en/undo_icon.png) 撤销在 [编辑](https://www.metatrader5.com/zh/metaeditor/help/main_menu/main_menu_edit#undo) 菜单里或按 Ctrl+Z。样式器支持多种编码标准。可以在[编辑器设置](https://www.metatrader5.com/zh/metaeditor/help/beginning/settings#styler)中更改样式。下面将详细描述MetaQuotes推荐样式的设计规则。 ## 常规 在样板中提供以下动作类型以便正确格式化代码: - 用指定内容替换某些行; - 对齐语言运算符; - 将注释插入文件标题; - 在函数、结构、类及其方法之前插入注释; - 在文件末尾插入注释。 基于上述动作类型，样板进行以下调整: ## 空格和空行 删除不必要的空格符可令您编写的代码更紧凑，从而改善其观感。 此外，样板将每个制表符替换为三个空格，以避免在第三方程序中打开时可能导致的格式失真。 ### 样板删除空格: - 在行的末尾; - 在 ";" 之前; - "if" 和 "(", "while" 和 "(", "for" 和 "(", "switch" 和 "(", "return" 和 "(" 之间。 - 在 ";" 之后且在 "for()" 之内; - 在 "!" 之后; - 在 "(" 和 ")" 附近; - 在 "<" 和 ">" 附近; - 在 "|" 和 "^" 附近; - 在 "+", "-", "/" 和 "%" 附近; - 在 "[" 和 "]" 附近; - 在 "==" 和 "==" 附近; - 在 "!=" 和 "!=" 附近; - 在 "<=" 和 ">=" 附近; - 在 "+=" 和 "+=" 附近; - 在 "-=" 和 "-=" 附近; - 在 "*=" 和 "*=" 附近; - 在 "/=" 和 "/=" 附近; - 在 "<<" 和 ">>" 附近; - 在 "," 和 "=" 左右侧各一个空格。 ### 样板设定: - 在 "||" 和 "&&" 左右侧各一个空格 (结果: " || " 和 " && ")。 ### 其它替换: - 在 "int* a" 类型的构造器中, 字符 "*" 和 "&" 指的是一个变量而不是类型，所以这个设计被替换为 "int *a"; - 双重空行由一行替换。 | 格式化之前 | 格式化之后 | | --- | --- | | ```
void myFunction()
{
if (I < 10)
{
printf (“Hello\n”) ;
if (I < 5 )
{
printf (“i<5 !\n”) ;
if (i < 3)
{
printf (“i<3 !\n”) ;
if (i < 2)
{
}
}
}
}
}
``` | ```
void myFunction()
{
if(I<10)
{
printf(“Hello\n”);
if(I<5)
{
printf(“i<5 !\n”);
if(i<3)
{
printf(“i<3 !\n”);
if(i<2)
{
}
}
}
}
}
``` | > 无论 [MetaEditor 设定](https://www.metatrader5.com/zh/metaeditor/help/beginning/settings#tab) 如何，样板的制表符总是等于三个空格。 ## 当格式化要考虑行间对齐时则排除替换 以上指定的样板替换规则在某些情况下不适用。 这样做是为了不违反相邻行上的版权对齐规定。 样板由以下关键字和符号识别下一行的行间对齐: - "//" ― С 风格的注释符号; - "{" ― 开口大括号; - "}" ― 封口大括号; - "return" ― "return" 操作符; - "delete" ― "delete" 操作符; - "=" ― 等号; - ":" ― 冒号; - "." ― 句号。 如果样板在前一行或随后一行中找到与上述单词或符号相同的位置，则不会进行替换。 ## 格式化函数和操作符 - 在函数/操作符类型声明的开口和封口 "{" 和 "}" 符号之前加入两个空格。 - 位于函数/操作符的 "{" 和 "}" 符号之间的每一行，操作符开始之前均放置三个空格。 - 在未封口 "{" 或 "}" 符号的同一行内有文本情况下, 这些符号和文本会被整理到不同的行。 - 考虑到前一行的内容，也执行对齐。 如果括号未封闭，或者算术表达式在前一行中尚未完整，则当前行从前一行的 "(" 或 "=" 的第一个位置开始。 - 条件分支 "else" 总是设定与 "if" 相同。 | 格式化之前 | 格式化之后 | | --- | --- | | ```
void myFunction() {
int k[10],t=0;
for(int i=0;i<10;i++){
k[i]=i;
t+=i;}
if (button==name) {
bool state=ObjectGetInteger(0,name,OBJPROP_STATE);
if(!state)
ObjectSetInteger(0,name,OBJPROP_STATE,false);}
else {
ObjectSetInteger(0,name,OBJPROP_STATE,false);}
}
``` | ```
void myFunction()
{
int k[10],t=0;
for(int i=0;i<10;i++)
{
k[i]=i;
t+=i;
}
if(button==name)
{
bool state=ObjectGetInteger(0,name,OBJPROP_STATE);
if(!state)
ObjectSetInteger(0,name,OBJPROP_STATE,false);
}
else
{
ObjectSetInteger(0,name,OBJPROP_STATE,false);
}
}
``` | ## 当声明结构、类和枚举时进行对齐 这种表述也适用于所谓的两级制表: - 声明成员/方法的指定类型之前放置三个空格; - 声明结构或类的成员及方法时，其名称要从每一行的第 22 个字符位开始指定; - 访问成员和方法的定域符 ("private", "protected", "public" 和 "virtual") 要与 "class" 保留字对齐。 | 格式化之前 | 格式化之后 | | --- | --- | | ```
class CTradePad {
private:
int m_rows;
int m_columns;
int m_button_width;
int m_button_height;
int m_top;
int m_left;
int m_left_previous_header;
};
``` | ```
class CTradePad
{
private:
int m_rows;
int m_columns;
int m_button_width;
int m_button_height;
int m_top;
int m_left;
int m_left_previous_header;
};
``` | ## 注释对齐 声明和定义中的注释有不同的对齐方式: - 函数或方法定义中的第一级注释与左侧对齐（没有缩进）; - 声明中的第一级注释与每行的第三个字符位对齐; - 随后级别的注释与它们所处操作符的相应级别等同。 | 格式化之前 | 格式化之后 | | --- | --- | | ```
void myFunction() {
//--- 第一级注释
int k[10],t=0;
for(int i=0;i<10;i++){
k[i]=i;
t+=i;}
if (button==name) {
bool state=ObjectGetInteger(0,name,OBJPROP_STATE);
//--- 第二级注释
if(!state)
ObjectSetInteger(0,name,OBJPROP_STATE,false);}
else {
ObjectSetInteger(0,name,OBJPROP_STATE,false);}
}
``` | ```
void myFunction()
{
//--- 第一级注释
int k[10],t=0;
for(int i=0;i<10;i++)
{
k[i]=i;
t+=i;
}
if(button==name)
{
bool state=ObjectGetInteger(0,name,OBJPROP_STATE);
//--- 第二级注释
if(!state)
ObjectSetInteger(0,name,OBJPROP_STATE,false);
}
else
{
ObjectSetInteger(0,name,OBJPROP_STATE,false);
}
}
``` | | ```
class CTradePad
{
private:
int m_rows;
//--- 行数
int m_columns;
//--- 列数
int m_button_width;
//--- cell width

};
``` | ```
class CTradePad
{
private:
int m_rows;
//--- 行数
int m_columns;
//--- 列数
int m_button_width;
//--- 单元宽度

};
``` | ## 插入注释 如果文件头缺失，则将以下形式的注释插入到文件头中: ``` //+------------------------------------------------------------------+ //| ProjectName | //| Copyright © 2009, CompanyName.| //| http://www.companyname.net | //+------------------------------------------------------------------+ ``` 当缺失时，以下形式的注释会插入函数、类、结构等之前: ``` //+------------------------------------------------------------------+ //| | //+------------------------------------------------------------------+ ``` 在文件末尾插入以下类型的截止注释: ``` //+------------------------------------------------------------------+ ``` ## In this section - [智能管理](https://www.metatrader5.com/zh/metaeditor/help/development/intelligent_management) - [查找和替换](https://www.metatrader5.com/zh/metaeditor/help/development/source_code_find) - 样板 - [编译](https://www.metatrader5.com/zh/metaeditor/help/development/compile) - [MQL5 云端保护: 为程序提供先进的保护](https://www.metatrader5.com/zh/metaeditor/help/development/mql5_cloud_protector) - [代码调试](https://www.metatrader5.com/zh/metaeditor/help/development/debug) - [代码分析](https://www.metatrader5.com/zh/metaeditor/help/development/profiling) - [AI Assistant编码助手](https://www.metatrader5.com/zh/metaeditor/help/development/ai_assistant) - [生成包含代码](https://www.metatrader5.com/zh/metaeditor/help/development/generate_mqh) - [调用 C++ 的 DLL (与 MS Visual Studio 集成)](https://www.metatrader5.com/zh/metaeditor/help/development/c_dll) - [使用Python](https://www.metatrader5.com/zh/metaeditor/help/development/python) - [OpenCL 支持](https://www.metatrader5.com/zh/metaeditor/help/development/opencl) ```json {"@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ {"@type": "ListItem", "position": 1, "item": {"@id": "https://www.metatrader5.com/zh/metaeditor/help", "name": "MetaEditor 帮助"}}, {"@type": "ListItem", "position": 2, "item": {"@id": "https://www.metatrader5.com/zh/metaeditor/help/development", "name": "开发程序"}}, {"@type": "ListItem", "position": 3, "item": {"@id": "https://www.metatrader5.com/zh/metaeditor/help/development/styler", "name": "样板"}} ]} { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{ "@type": "Question", "name": "MetaTrader 5: 样板", "acceptedAnswer": { "@type": "Answer", "text": "样板能很快将源代码布局按照建议标准保持一致。 这令代码看起来专业且易于阅读。 设计良好的代码在未来对作者和其他用户来说更容易分析。 若要启动样板，请单击 位于 工具 菜单里的样板，或按 Ctrl+,。 在样板中提供以下动作类型以便正确格式化代码: 用指定内容替换某些行; 对齐语言运算符..." } }] } ```