苹果Objective-C编码规范详解

"苹果编码规范.PDF" 苹果编码规范是一份重要的文档，主要针对苹果平台上的Objective-C编程语言，旨在提供一套统一的代码风格和最佳实践，以提高代码的可读性和团队间的协作效率。这份规范由Daniel'sObjective-CCodingStyleGuidelines整合，参考了Apple、Google以及Three20等机构的指导原则。 1. **格式化代码**： - **指针“*”号的位置**：推荐将指针的“*”号放在变量类型前，如`NSString*varName;`，这有助于快速识别变量是否是对象指针。 - **空格与制表符**：只使用空格进行缩进，且设置编辑器的1个TAB等于2个字符的缩进距离，保持一致性。 - **每行长度**：规定每行代码不应超过100个字符。这是基于15寸Macbook Pro屏幕大小的考虑，以便同时显示编辑器和iPhone模拟器，避免频繁换行。 - **提醒设置**：可以通过Xcode的偏好设置，启用显示页边距（ShowPageGuide）并在100字符位置设置提示，以辅助开发者遵循行长度限制。 2. **方法声明与定义**： - **空格的使用**：在“-OR+”和返回值之间，以及方法名和第一个参数之间应留一个空格。例如：`-(void)doSomethingWithString:(NSString*)theString;` - **长参数处理**：当参数过多时，每个参数占用一行，并以冒号对齐。例如： ```objc -(void)doSomethingWith:(GTMFoo*)theFoo rect:(NSRect)theRect interval:(float)theInterval{ } ``` - **方法名与参数名长度差异**：如果方法名比参数名短，每个参数应独立成行，缩进至少4个字符，保持垂直对齐，而不是用冒号对齐。例如： ```objc -(void)short:(GTMFoo*)theFoo longKeyword:(NSRect)theRect evenLongerKeyword:(float)theInterval{ } ``` 3. **方法调用**： - 调用方法的风格应与声明方法保持一致，除非源文件已存在特定风格，此时应遵循源文件的风格。 - 参数可以在同一行内，或者每参数占一行并使用冒号对齐，例如： ```objc [myObject doFooWith:arg1 name:arg2 error:arg3]; 或 [myObject doFooWith:arg1 name:arg2 error:arg3]; ``` 这些规范不仅适用于新手开发者提前学习，也适用于有经验的开发者在维护和编写苹果平台应用时遵循，确保代码的整洁和一致性。遵循这些规则，可以提高代码的可读性，降低维护成本，并提升团队合作的效率。