Python中变量名与函数kwarg参数同名算不算不良实践？

首先明确：这种写法不属于通用意义上的不良实践 #

这种参数名=同名变量的写法是完全合法的Python语法，PEP8规范中也没有相关的禁用要求。在变量定义位置离调用点很近、上下文清晰的场景下，这种写法反而可读性很高，读者可以一眼看出你把哪个语义的变量传给了对应语义的参数，很多开源项目的代码中也会大量出现这类写法。

只有在以下少数场景下，这种写法会带来可维护性问题：

• 变量定义和函数调用的代码相隔几十行以上，读者需要来回翻找才能确认dotenv_path是你定义的变量还是参数本身
• 存在多层作用域嵌套（比如你在函数内部又定义了同名变量、或者外层作用域也有同名变量），容易出现作用域混淆

不需要修改变量名的优化方法 #

如果你确实觉得需要区分两者，可以用以下几种通用方案，不会损失可读性和自文档性：

1. 短上下文场景直接省略参数名传递
   如果参数位置固定、你可以确定后续函数的参数顺序不会发生变化，直接按位置传参即可：

   # 原写法 load_dotenv(dotenv_path=dotenv_path)
   load_dotenv(dotenv_path)
   

   注意这种方法不适合参数数量多、参数顺序可能变动的函数，避免传参顺序出错。

2. 单一场景直接内联变量
   如果这个路径变量你只会用这一次，不需要复用，直接把值写在参数里即可，完全不需要额外定义变量：

   load_dotenv(dotenv_path=r"./../.env")
   

3. 用作用域前缀标识局部变量
   给你自己定义的变量加上统一的作用域前缀，比如local_、模块级变量加MOD_这类约定俗成的前缀，既保留了原本的语义，又能和参数名明确区分：

   local_dotenv_path = r"./../.env"
   load_dotenv(dotenv_path=local_dotenv_path)
   

4. 多参数场景用字典解包传递
   如果你需要同时传多个参数给函数，可以把参数统一存在配置字典里，用**解包传递，适合配置项多、需要统一管理的场景：

   dotenv_opts = {
       "dotenv_path": r"./../.env",
       "override": True,
       "encoding": "utf-8"
   }
   load_dotenv(**dotenv_opts)
   

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