局部变量仅在定义的作用域内有效，用local声明、避免全局污染、不可导出，是提升Shell脚本健壮性的关键。

在 Linux Shell 脚本中，局部变量只在定义它的作用域内有效，不会被子进程继承，也不会影响其他脚本或当前 shell 的全局环境。合理使用局部变量是避免命名冲突、防止意外覆盖系统变量、提升脚本健壮性的关键做法。

用 local 关键字声明函数内变量

函数内部的变量默认是全局的，除非显式声明为局部。只要在函数里用 local 修饰，该变量就仅限于函数体内使用，退出函数后自动失效。

• 写法必须是 local varname=value，等号两边不能有空格
• 支持同时声明多个：local a=1 b="test" c（c 未赋值，为空字符串）
• 若在函数外误用了 local，bash 会报错或忽略，不推荐在全局作用域使用

函数外避免定义不必要的全局变量

脚本顶层（函数外）定义的变量默认就是全局的，容易和系统变量或后续脚本冲突。除非确实需要跨函数共享，否则应尽量减少顶层变量。

Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。

下载

• 优先把逻辑封装进函数，变量放在函数内用 local 管理
• 如果只是临时计算或中间结果，比如 tmp=$(date +%s)，建议直接用命令替换，不存为变量
• 自定义变量名一律用小写字母（如 my_config_path），避开全大写（如 PATH、HOME），防止覆盖系统变量

区分局部变量与导出变量

即使你定义了一个变量，只要没执行 export，它就不会变成环境变量，也就不会传给子进程。这是隔离变量影响范围的底层机制。

• count=5 → 仅当前 shell 可见，fork 出的子 shell 看不到
• export count=5 → 子进程也能读取，但仍是当前 shell 的变量，修改子进程的 count 不会影响父进程
• 局部变量天然不具备可导出性；一旦 export local_var，bash 会忽略 local 属性，实际导出的是全局变量

调试时快速识别变量作用域

运行脚本时，可通过 set 命令查看所有已定义变量（含局部），再结合上下文判断是否“泄漏”到了不该出现的地方。

• printenv 只显示导出的全局环境变量，不含纯局部变量
• set | grep "^myvar=" 可检查变量是否存在且值正确（注意 set 输出按字母排序）
• 在函数开头加 local -p（Bash 4.2+）能只打印当前函数内的局部变量列表