Linux系统配Codex var声明替换：let/const现代化语法升级实操说明

必须用bash 4.3+的declare -r模拟const、let替代算术运算，并将裸赋值改为declare声明以启用局部作用域；整数运算统一改用带引号的let命令，关键常量加declare -r并配合set -o nounset启用严格模式。

要在Linux Shell脚本中把老旧的var变量声明方式替换成更安全、作用域更清晰的let/const风格语法，必须绕过Shell本身不支持const和块级作用域的限制，转而用bash 4.3+的declare -r模拟const语义，并用let替代所有整数运算中的$((...))或expr调用。

识别并替换传统var赋值语句

打开目标Shell脚本，全局搜索形如VAR=value或VAR="string"的未声明直接赋值语句。这类写法在bash中默认创建全局可变变量，无类型约束，易被意外覆盖。

将每处裸赋值改为declare VAR=value——这一步强制启用局部作用域（在函数内时）并避免污染全局命名空间。

【注意：declare必须放在变量首次使用之前，否则无效】

整数运算统一改用let命令

查找所有含算术运算的行，包括i=$((i+1))、expr $i + 1、let i=i+1等变体。

方法一：直接替换为let "i += 1"——双引号包裹确保空格和运算符被正确解析，避免因未引号导致的语法错误。

方法二：对多变量复合运算，如a=$((b*c+d))，改写为let "a = b * c + d"。此处bcd必须是已定义的整数变量，否则let会静默失败且返回非零退出码。

【let只处理整数，浮点运算会截断小数部分，不可逆】

模拟const语义锁定关键常量

第一步：定位脚本中明确不会变更的配置项，例如MAX_RETRY=3、LOG_DIR="/var/log/app"。

第二步：将它们批量替换为declare -r MAX_RETRY=3和declare -r LOG_DIR="/var/log/app"。

第三步：在脚本开头添加set -o nounset——启用未定义变量报错模式，配合declare -r形成双重防护：一旦尝试修改readonly变量，bash立即终止执行并输出bash: MAX_RETRY: readonly variable。

这一步不可跳过，否则declare -r仅在当前shell层级生效，子shell仍可覆盖。

验证let/declare语法兼容性

执行bash --version确认版本不低于4.3；低于该版本的declare -r不支持数组和关联数组只读，且let某些运算符（如**幂运算）不可用。

运行bash -n your_script.sh进行语法预检：若出现syntax error near unexpected token `&'之类提示，说明某处let表达式漏了引号，含&|等shell元字符时必须引起来。

实际执行前先跑一遍set -u -e——开启未定义变量报错和任一命令失败即退出，能快速暴露因declare未前置导致的变量未声明错误。