如何修复pylint C0103:invalid-name模块名命名不规范报错？

报错原因 #

Pylint 默认遵循PEP8编码规范，强制要求Python模块（即.py格式的代码文件）文件名使用snake_case（蛇形命名，全小写、单词间用下划线分隔）风格，你当前使用的驼峰格式文件名pyBasics不符合默认校验规则，因此触发该告警。

修复方案 #

方案1：遵循规范修改文件名（推荐） #

直接将当前文件重命名为符合蛇形命名要求的格式即可，例如将pyBasics.py改为py_basics.py。修改完成后Pylint会自动重新校验代码，报错会直接消失。该方案完全符合Python社区通用编码规范，无额外配置成本，优先推荐使用。

注意：如果项目中其他文件有引用该模块，重命名后需要同步修改对应import语句的路径，避免导入报错。

方案2：调整Pylint规则适配现有命名 #

如果不想修改现有文件名，可以通过配置调整Pylint的校验规则，按需选择以下配置方式：

• 单文件屏蔽：如果仅需要当前文件不触发该报错，在对应.py文件的最顶部添加如下注释即可：

# pylint: disable=C0103

保存后当前文件下所有命名类（C0103）的告警都会被屏蔽。

• 项目级规则调整：如果需要整个项目都支持驼峰格式的模块名，在项目根目录新建.pylintrc配置文件，写入如下配置即可自定义模块名的匹配规则：

[BASIC]
# 正则匹配支持蛇形命名、大驼峰命名两种模块名格式，可按需调整
module-rgx=(([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$

• 全局关闭校验：如果不需要Pylint校验任何命名格式，可以在VS Code设置中搜索pylint Args，添加参数--disable=C0103，即可全局关闭该类报错，该方式会屏蔽所有命名不规范的提示，非特殊需求不推荐使用。

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