local 是 Lua 语言里面的关键字，核心作用是声明局部变量，和默认的全局变量做区分，使用 local 声明之后，这个变量的生效范围只局限在当前代码块内部，代码块执行结束之后变量就会自动销毁，不会污染全局环境，之所以设计 local 这个关键字，是因为 Lua 默认不写 local 的变量全部都是全局变量，全局变量会一直保存在内存里面，多个脚本互相调用的时候很容易出现变量重名覆盖，程序运行变慢还会产生难以排查的 bug，加上 local 之后可以提升运行效率，减少内存占用，是 Lua 开发里面非常基础而且必须掌握的语法，除了 Lua 之外，部分其他语言或者配置文件里面也会见到 local 这个单词，含义大多代表本地，比如 local 存储本地缓存，但是最常提问的场景就是 Lua 的 local 关键字，下面分层讲解语法规则，作用原理，和全局变量对比，使用场景还有常见误区，内容按照技术文档风格整理，方便学习查阅。

基础语法规则

写 local 之后跟上变量名，就完成局部变量声明，也可以在同一行直接赋值，支持一次性声明多个局部变量，多个变量之间用逗号隔开，还可以同时给多个变量赋值，作用域就是它所在的代码块，代码块可以是函数内部，if 判断分支，for 循环，while 循环，或者用 do end 包裹的独立区块，一旦离开这个代码块，local 声明的变量就不再可以访问，强行读取会变成 nil 空值。

local 核心作用

第一 隔离变量作用域，避免不同代码块里面同名变量互相覆盖，全局变量没有隔离，脚本 A 修改同名全局变量，脚本 B 读取的时候就会被意外改动，local 可以把变量锁在自己的代码块内部。

第二 优化程序性能，Lua 访问局部变量速度比全局变量更快，因为全局变量是存放在全局表里面，每次读取都需要查表，local 变量存放在寄存器或者栈空间，查找速度更高，循环里面大量运算的时候，使用 local 性能差距会很明显。

第三 自动释放内存，代码块执行完毕，local 变量没有其他引用的时候就会被垃圾回收，不会长期占用内存，全局变量只要不手动删除，就一直驻留在全局表。

第四 代码可读性更好，看到 local 就知道这个变量只在当前区域使用，维护代码的时候能快速理解变量生命周期。

典型使用场景

函数内部临时计算变量，绝大多数函数内部的临时参数中间计算值，都推荐加上 local 声明。

循环内部临时计数器，for 循环里面的临时变量，本身就是 local 性质，自定义循环临时变量推荐加 local。

模块内部私有变量，写 Lua 模块的时候，用 local 声明模块内部私有数据，外部脚本无法直接读取，实现封装效果。

local 局部变量和全局变量对照表

常见误区

误区一 只要写了 local，在整个文件都能访问，这个是错误的，跨出所在代码块之后变量就失效。

误区二 local 只能声明数字变量，实际上 local 可以声明任意类型，字符串，表，函数都可以。

误区三 局部变量和全局变量同名的时候，代码块内部优先读取 local 局部变量，这个叫变量遮蔽，写代码要留意，避免逻辑出错。

【常见问题】

问题 1 Lua 里面 local 和不写 local 最大区别是什么

回答 1 Lua 里面 local 用来声明局部变量，local 的变量只在代码块内部生效，不写 local 就是全局变量，local 可以防止变量污染还能提升运行速度，这就是 local 和普通全局变量最大区别。

问题 2 为什么循环里面推荐使用 local

回答 1 循环里面使用 local 声明临时变量，local 变量访问速度更快，循环结束之后 local 变量自动回收内存，大量循环运算场景下，使用 local 可以明显优化程序性能。

问题 3 模块里面用 local 声明的变量外部还能读取吗

回答 3 模块里面使用 local 声明的私有变量，外部脚本不能直接读取，local 的作用域限制在模块内部，这个特性就是 local 实现代码封装的核心用途。

【免责申明】

本文内容仅作为 Lua 编程语法学习参考，不同版本 Lua 语法细节存在小幅差异，实际项目开发请对照官方手册，不替代专业开发文档。