local用于在shell函数内声明局部变量，确保其仅在函数内有效、退出后自动销毁，且不干扰同名全局变量；必须在函数内使用，支持数组、只读、整数等属性修饰。

在 Shell 函数中用 local 定义变量，能确保该变量只在函数内部有效，退出函数后自动销毁，不会覆盖或干扰同名的全局变量。

local 只在函数作用域内生效

local 必须在函数体内使用，且必须在变量首次赋值前声明（Bash 4.2+ 允许声明同时赋值）。它不能用于全局作用域，否则会报错或被忽略。

• 正确写法：local name="alice" 或先 local name 再 name="alice"
• 错误写法：local 放在函数外、或写成 local=xxx（语法错误）
• 注意：子 shell（如 (...)）也有独立变量空间，但 local 不影响它——local 管的是函数栈帧，不是子进程

避免同名变量意外覆盖

没有 local 时，函数内直接赋值的变量默认是全局的。多个函数用相同变量名容易互相干扰。

Shell脚本编写基础 中文WORD版

Shell本身是一个用C语言编写的程序，它是用户使用Linux的桥梁。Shell既是一种命令语言，又是一种程序设计语言。作为命令语言，它交互式地解释和执行用户输入的命令；作为程序设计语言，它定义了各种变量和参数，并提供了许多在高级语言中才具有的控制结构，包括循环和分支。它虽然不是Linux系统核心的一部分，但它调用了系统核心的大部分功能来执行程序、建立文件并以并行的方式协调各个程序的运行。因此，对于用户来说，shell是最重要的实用程序，深入了解和熟练掌握shell的特性极其使用方法，是用好Linux系统

下载

• 比如两个函数都写 tmp="/tmp/data"，第二个会改掉第一个留下的值
• 加上 local tmp 后，每个函数都有自己的 tmp，互不看见
• 即使函数里读取了全局 tmp，只要没声明 local tmp，后续赋值仍会改全局变量

local 支持数组和属性修饰

Bash 中 local 可配合数组声明和属性（如 -i 整数、-r 只读），增强安全性。

• 数组：local -a list=(a b c) —— 创建局部索引数组
• 关联数组：local -A map=([x]=1 [y]=2)
• 只读局部变量：local -r PATH="/usr/local/bin:$PATH"（防止被意外修改）
• 整数变量：local -i count=0，后续 count+=1 才按数值运算，否则当字符串拼接

兼容性与替代方案

local 是 Bash、Zsh、Ksh 支持的扩展，POSIX sh 不支持。写可移植脚本时需注意：

• 用 #!/bin/bash 明确解释器，避免在 dash/sh 下运行出错
• 若必须兼容 POSIX，可用子 shell 封装：(tmp="xxx"; do_something) —— 但无法返回变量值给父 shell
• 也可用命名前缀模拟局部性，如 myfunc_tmp，但不如 local 干净可靠