# 注释与代码风格规范

URL: https://caijiao.org/swift/02-basics/04-comments
Source: docs/swift/02-basics/04-comments.md
Description: 本章讲解 Swift 中的注释写法及代码风格规范，帮助开发者提高代码可读性和维护性，养成良好编程习惯。

注释用于解释代码意图，提升代码可读性。Swift 支持单行和多行注释：

- 单行注释以 `//` 开头：

```swift
// 这是单行注释
let x = 10
````

* 多行注释使用 `/* ... */` 包裹：

```swift
/*
  这是多行注释，
  可以写多行说明
*/
let y = 20
```

## 代码风格规范

* 使用驼峰命名法（camelCase）命名变量和函数，如 `userName`、`fetchData()`。
* 每行代码长度控制在 80-120 字符以内，保持整洁。
* 合理使用空格和缩进，通常采用 4 个空格缩进。
* 函数、类型和变量的命名要清晰、有意义。
* 及时添加注释，说明复杂逻辑和关键代码。

遵守规范有助于团队协作和代码维护。