如何让PyCharm读取pyproject.toml的pylint配置并解决报错？

1. 清空无效的Pylint配置文件路径 #

打开PyCharm的File > Settings > Tools > Python Integrated Tools，找到Pylint设置区域：

• 把Configuration file选项改成「自动检测」，或者直接清空手动填写的pylintrc路径（旧版本遗留的手动配置会和pyproject.toml冲突）
• 保存设置后重新触发Pylint扫描

2. 检查pyproject.toml的格式与位置 #

• 确保文件放在项目根目录（PyCharm左侧面板带蓝色图标的根目录）
• 配置块必须以[tool.pylint]开头，示例格式如下：

  [tool.pylint]
  disable = ["C0114", "C0116"]  # 禁用缺少docstring的警告
  max-line-length = 120
  enable = ["W0611"]  # 启用未导入模块的警告
  

3. 命令行验证Pylint配置有效性 #

打开PyCharm内置Terminal，切换到项目根目录，执行：

pylint --recursive=y .

如果命令行能正常扫描无报错，说明配置文件本身没问题，问题出在PyCharm的缓存或设置；如果命令行也报错，检查pyproject.toml的语法错误（比如括号、逗号是否正确）

4. 重置PyCharm缓存（终极方案） #

如果以上步骤无效，执行：
File > Invalidate Caches... > 选择Invalidate and Restart
重启后PyCharm会重新加载所有项目配置，大概率能解决识别问题

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