Lua全局变量命名首字母应使用大写还是小写？

首先明确：这个提示不是Lua语法的强制要求，是VS Code里安装的Lua静态检查插件（最常见的是Lua LSP、luacheck）内置的社区规范校验，你写的score = 0在语法上完全合法，运行不会有任何问题。

针对你提的三个问题，具体说明如下：

全局变量是不是必须大写开头？ #

• 这不是语法强制规则，是Lua生态里长期形成的通用约定。Lua本身的设计里，变量不加local修饰就会自动注册为全局变量，很多开发者都容易因为漏写local，意外创建出全局变量，造成变量污染、逻辑被意外篡改的bug。约定「全局变量首字母大写、局部变量首字母小写」，本质是给变量打了个肉眼可识别的作用域标签。
• 如果你写的score = 0确实是需要全局访问的变量，改成Score = 0或者常量风格的SCORE = 0就不会触发提示；如果你本来是想定义当前作用域的局部变量，补上local写成local score = 0即可。

这种命名约定对可读性、易检查性的提升大吗？ #

• 实际开发中提升非常明显。Lua的全局变量作用域是整个Lua虚拟机状态，任何位置的代码修改全局变量都会影响所有引用它的逻辑，排查bug的时候定位成本很高。靠首字母大小写做区分后，扫代码的时候不用特意往前翻找变量的声明位置：
  • 看到首字母小写的变量，默认是局部作用域，只需要检查当前代码块、当前文件内的逻辑即可
  • 看到首字母大写的变量，默认是全局作用域，修改时会特意留意会不会影响其他模块的逻辑
• 很多Lua项目还会引入严格模式脚本，直接禁止读写未提前声明的全局变量，和这个大小写约定搭配使用，基本能杜绝漏写local产生脏全局变量的低级问题。

这类命名规范是Lua独有的吗？ #

• 不是，靠命名约定区分作用域/可见性是很多编程语言的通用做法：
  • Go语言甚至把首字母大小写做成了编译器强规则：首字母大写的结构体、函数、变量是包外可访问的导出成员，首字母小写的仅包内可见，不遵守直接编译不通过
  • Python约定模块级的常量全大写，类内部不希望外部访问的私有属性前加单下划线前缀
  • C/C++、JavaScript等语言也长期存在宏定义、全局常量全大写的命名约定
  • Java、C#里也有常量全大写、类名首字母大写、普通变量小驼峰的成体系命名规范

实用建议 #

如果是你自己写个人小项目、测试demo，完全可以按自己的习惯来，嫌提示烦直接在LSP配置里关掉这条校验规则就行；如果是参与多人协作的Lua项目（比如游戏脚本、OpenResty服务开发），最好遵循这个通用约定，能减少很多不必要的沟通成本和低级bug。

内容的提问来源于stack exchange，提问作者user16999379