pycharm中需同时关闭pep 8实时高亮(inspections)和自动格式化(code style)两层设置:前者在editor → inspections中取消勾选对应pep 8检查项,后者在editor → code style → python中调整或设为none,并注意项目级配置与全局配置的区别。

PyCharm里PEP 8警告怎么关掉
直接关掉就行,但得知道关的是哪一层——PyCharm的PEP 8检查其实分两种:实时编辑时的高亮提示(Inspection),和保存/格式化时的自动修正(Code Style + Reformat)。很多人只关了前者,结果一按 Ctrl+Alt+L 还是被改得面目全非。
关闭实时PEP 8高亮(Inspection)
这是最常被误认为“没关掉”的地方。它不改变代码,只是标黄/标红提醒你不符合PEP 8,比如行太长、空格不对、命名用下划线还是驼峰。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- 打开
Settings / Preferences → Editor → Inspections - 在搜索框输入
PEP 8,找到Python → PEP 8 naming convention violation、Line too long等具体项 - 取消勾选对应条目(建议别全关,只关你明确不想遵循的,比如
Constant name doesn't conform to UPPER_CASE naming style) - 注意:有些检查属于
Code style类别,不是PEP 8标签,比如Unused import是独立检查项,关错位置没用
禁用自动格式化里的PEP 8规则
即使关了高亮,PyCharm默认仍会在你按 Ctrl+Alt+L 或启用 Reformat on Save 时强行套用PEP 8风格。这才是真正“改你代码”的环节。
- 进
Settings / Preferences → Editor → Code Style → Python - 点右上角
Set from… → Predefined style → Google或None(选None最彻底,但会丢失所有缩进/空格等基础格式) - 更稳妥的做法:保留缩进、空格等基础规则,只关具体触发PEP 8冲突的选项,比如:
- 取消勾选
Ensure blank line after class docstring - 把
Continuation indent改成4(而非默认的8,避免换行缩进过深) - 在
Wrapping and Braces页签下,关掉Wrap on typing和Align when multiline
- 取消勾选
- 检查
Editor → General → Auto Import → Add unambiguous imports on the fly是否开着——它有时会插进多余空行,看着像PEP 8报错
项目级配置 vs 全局配置容易混淆
PyCharm的设置分两层:全局(Global)和项目(Project)。你在一个项目里关了PEP 8,新开项目默认还是开着的。
- 确认当前修改的是
Project而非Default Settings(右下角有切换按钮) - 如果团队协作,别乱动
.idea/codeStyles/Project.xml——这个文件会被Git提交,可能影响别人 - 真正想彻底隔离,用
pyproject.toml配flake8或pylint,然后在 PyCharm 中关掉内置检查,只留外部工具报告——这样既自由又可复现
snake_case,才意识到原来格式化开关还焊死在那儿。










