「Mac玩转仓颉内测版4」入门篇4 - Cangjie变量命名规则

本篇将详细介绍Cangjie编程语言中的变量命名规则。良好的命名习惯对代码的可读性和维护性至关重要。通过掌握普通标识符和原始标识符的命名规范，能够有效提升代码的清晰度和一致性。

关键词

• Cangjie变量命名
• 普通标识符
• 原始标识符
• 命名规范
• 可读性与维护性

---

一、变量命名规则

1.1 命名规范

变量命名是编写代码时需要遵循的重要规范，良好的命名可以提高代码的可读性与可维护性。Cangjie中的变量命名规则如下：

• 字符限制：变量名可以包含字母、数字和下划线，还支持中文、日文、韩文、泰文等字符，但不能以数字开头。
• 区分大小写：Cangjie区分大小写，即 variable 和 Variable 是两个不同的变量。
• 长度限制：建议不超过30个字符，选择短而有意义的名称。
• 命名一致性：在同一项目中保持命名的一致性，以提升可读性。

1.2 有效命名示例

• 有效命名：temperature, maxValue, result, b2c3d4, last_updated, x1_y2_z3, 程序, こんばんは, 안녕, สวัสดี
• 无效命名：2ndPlace（以数字开头）、total@Sum（含特殊符号）、9lives（以数字开头）、first name（含空格）

---

二、普通标识符与原始标识符

在Cangjie中，标识符分为普通标识符和原始标识符，具体定义如下：

2.1 普通标识符

• 定义：普通标识符用于命名变量、函数、类等元素的名称。
• 命名规则：
  • 必须以字母或下划线开头，后续可以包含字母、数字或下划线。
  • 不能使用Cangjie的关键字作为标识符。

2.2 原始标识符

• 定义：原始标识符允许使用Cangjie的关键字作为标识符，通过在关键字两侧添加反引号。

• 命名规则：

  • 反引号内的内容必须是合法的命名，但不能以数字开头，且不应包含特殊符号。
  • 示例：有效的原始标识符包括 `temperature`, `_maxValue`, `if`, `while`, `çøñfīg`, `안녕하세요`, `สวัสดี`。

• 无效示例：以下是一些不合法的原始标识符，因为反引号内的部分不符合普通标识符规则：

  • `total@Sum`
  • `9lives`
  • `first name`

---

三、命名建议

为了提高代码的可读性，建议遵循以下命名建议：

• 使用有意义的名称：选择能够清晰表达变量或函数用途的名称。
• 采用驼峰命名法：函数和变量名建议使用小写字母和驼峰命名法（例如 calculateTotal）。
• 常量命名：常量名使用全大写字母，单词间用下划线分隔（例如 MAX_LIMIT）。
• 避免使用缩写：除非非常常见，否则尽量避免使用不清晰的缩写。

---

四、示例代码解析

4.1 有效的普通标识符

以下是一些有效的普通标识符示例，展示了不同语言和命名规则的应用：

// 有效的普通标识符
let temperature: Float64 = 25.5             // temperature：有效的普通标识符
println(temperature)                        // 输出：25.500000

let _maxValue: Int64 = 100                  // _maxValue：有效的普通标识符，以下划线开头
println(_maxValue)                          // 输出：100

let result_: String = "Success"             // result_：有效的普通标识符，以下划线结尾
println(result_)                            // 输出：Success

let b2c3d4: Bool = true                     // b2c3d4：有效的普通标识符，包含字母和数字
println(b2c3d4)                             // 输出：true

let last_updated: String = "2024-09-28"     // last_updated：有效的普通标识符，使用下划线分隔
println(last_updated)                       // 输出：2024-09-28

let x1_y2_z3: Float64 = 3.14                // x1_y2_z3：有效的普通标识符，字母与数字结合
println(x1_y2_z3)                           // 输出：3.140000

let 程序: Int64 = 42                        // 程序：有效的普通标识符，使用中文字符
println(程序)                               // 输出：42

let こんばんは: Int64 = 10                  // こんばんは：有效的普通标识符，使用日文字符
println(こんばんは)                         // 输出：10

let 안녕: Int64 = 12                        // 안녕：有效的普通标识符，使用韩文字符
println(안녕)                               // 输出：12

let สวัสดี: Int64 = 12                     // สวัสดี：有效的普通标识符，使用泰文字符
println(สวัสดี)                             // 输出：12

4.2 有效的原始标识符

以下是一些有效的原始标识符示例，展示了如何使用反引号包裹关键字和特殊字符：

// 有效的原始标识符
let `temperature`: Float64 = 5.0             // `temperature`：有效的原始标识符
println(`temperature`)                       // 输出：5.000000

let `_maxValue`: Int64 = 10                  // `_maxValue`：有效的原始标识符
println(`_maxValue`)                         // 输出：10

let `b2c3d4`: Int64 = 15                     // `b2c3d4`：有效的原始标识符
println(`b2c3d4`)                            // 输出：15

let `if`: Int64 = 20                         // `if`：有效的原始标识符，Cangjie关键字
println(`if`)                                // 输出：20

let `while`: Int64 = 25                      // `while`：有效的原始标识符，Cangjie关键字
println(`while`)                             // 输出：25

let `çøñfīg`: String = "Configured"          // `çøñfīg`：有效的原始标识符，包含特殊字符
println(`çøñfīg`)                            // 输出：Configured

let `안녕하세요`: Int64 = 35                  // `안녕하세요`：有效的原始标识符，使用韩文字符
println(`안녕하세요`)                         // 输出：35

let `สวัสดี`: Int64 = 40                     // `สวัสดี`：有效的原始标识符，使用泰文字符
println(`สวัสดี`)                            // 输出：40

4.3 无效的普通标识符

以下是一些无效的普通标识符示例，展示了不符合命名规则的情况：

// 无效的普通标识符
let 2ndPlace: Int64 = 1                        // 2ndPlace：无效，不能以数字开头
let total@Sum: Int64 = 2                       // total@Sum：无效，含特殊符号
let 9lives: Int64 = 3                          // 9lives：无效，不能以数字开头
let first name: String = "Hello"               // first name：无效，含空格

4.4 无效的原始标识符

以下是一些无效的原始标识符示例，展示了反引号内不合法的命名情况：

// 无效的原始标识符（因反引号内的部分是不合法的普通标识符）
let `total@Sum`: Int64 = 0                    // `total@Sum`：无效，反引号内含特殊符号
let `9lives`: Int64 = 0                       // `9lives`：无效，反引号内以数字开头
let `first name`: String = "Invalid"          // `first name`：无效，反引号内含空格

4.5 大小写区分示例

Cangjie区分大小写，以下示例展示了不同大小写的变量名被视为不同的变量：

let variable: Int64 = 10                // variable
let Variable: Int64 = 20                // Variable：与variable不同

println(variable)                       // 输出：10
println(Variable)                       // 输出：20

---

小结

本篇介绍了Cangjie中的变量命名规则，包括普通标识符和原始标识符的命名规范。通过有效与无效的命名示例，展示了如何正确地命名变量，并强调了命名一致性和可读性的重要性。同时，通过示例代码演示了Cangjie的大小写区分特性，帮助您更好地理解和应用这些命名规则。

---

下篇预告

下一篇将深入探讨Cangjie中的控制结构，包括条件判断和循环结构，帮助您更好地控制程序的执行流程，敬请期待！

---

上一篇：「Mac玩转仓颉内测版3」入门篇3 - Cangjie的基本语法与结构

下一篇：「Mac玩转仓颉内测版5」入门篇5 - Cangjie控制结构（上）

---

作者：SoraLuna 链接：https://www.nutpi.net/ 來源：坚果派 著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

---