0

0

Python 合规检查清单的设计

舞夢輝影

舞夢輝影

发布时间:2026-02-24 20:57:10

|

410人浏览过

|

来源于php中文网

原创

用 ast 检查变量命名是否符合 pep 8,需遍历 ast.name 节点中 ctx 非 ast.load 的定义处,对 node.id 用正则 ^a-z*$ 校验,排除私有变量和全大写常量,并覆盖 lambda、with、for 等易漏场景。

python 合规检查清单的设计

怎么用 ast 检查变量命名是否符合 PEP 8

直接解析源码抽象语法树,比正则匹配更可靠,能避开字符串、注释里的误报。

  • ast.walk() 遍历所有 ast.Name 节点,过滤掉 ctxast.Load 的(只检查定义/赋值处)
  • node.id 做正则判断:^[a-z][a-z0-9_]*$,但注意要排除下划线开头的私有变量(如 _internal)和全大写常量(如 MAX_RETRY
  • 常见坑:lambda 参数、with 中的 as 变量、for 循环的 target 都算变量定义,容易漏掉 ast.For.targetast.comprehension.target

为什么不能只靠 pylintflake8 做合规检查

它们是通用 linter,规则粒度粗、配置耦合重,很难嵌入 CI 流程做定制化拦截。

  • pylintvariable-rgx 只控制模块级变量,对函数内局部变量无效;flake8 根本不校验命名风格
  • 当你要禁止某类命名(比如禁止出现 tmpdata 这种模糊名),必须写自定义 checker 插件,而插件加载机制在不同 Python 版本间不稳定
  • 真实场景中,你可能需要“仅检查 tests/ 目录下的断言变量名”,这种路径+语义组合,原生工具不支持

ast.NodeVisitorast.walk() 选哪个

看是否需要上下文状态。简单遍历用 walk() 更轻量;需跨节点判断(比如检查变量是否在 try/except 内被赋值)必须用 NodeVisitor

MediPro网上书店系统
MediPro网上书店系统

基于PHP+MYSQL开发,除了网上书店必备的商品管理、配送支付管理、订单管理、会员分组、会员管理、查询统计和多项商品促销功能,还具有完整的文章、图文、下载、单页、广告发布等网站内容管理功能。系统具有静态HTML生成、UTF-8多语言支持、可视化模版引擎等技术特点,支持多频道调用不同模版和任意设置频道首页,适合建立各种规模的网上书店。系统具有以下主要功能模块: 网站参数设置 - 对网站的一些参数进

下载
  • ast.walk() 返回生成器,内存友好,适合单次扫描类检查(如找所有 print() 调用)
  • NodeVisitor 允许你在进入/退出节点时维护栈或字典,比如记录当前函数名,从而给变量打上作用域标签
  • 性能差异不大,但误用 NodeVisitor.visit() 忘记调用 super().visit() 会导致子节点跳过——这是最常踩的坑

如何让检查结果能被 IDE 实时高亮

关键不是写检查逻辑,而是输出格式必须匹配 IDE 的解析协议。

立即学习Python免费学习笔记(深入)”;

  • VS Code 的 Python 扩展只认 pylintmypy 格式;PyCharm 则支持自定义外部工具,但要求每行输出为:file.py:42:12: E123 Variable name 'FooBar' doesn't match regex '^[a-z]'
  • 不要用 print() 直接输出,封装成函数返回标准错误元组:(filepath, lineno, col, code, message)
  • 路径必须是相对路径(从项目根目录起),否则 PyCharm 显示“文件未找到”——这点容易被忽略
合规检查不是越严越好,真正卡住的是那些影响协作理解的点,比如同一模块里 user_iduserId 并存。其余细项,留到 code review 里人工判断更实际。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

192

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

13

2026.02.03

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1558

2023.10.24

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

638

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

217

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1558

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

642

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

1027

2024.03.22

Golang 生态工具与框架:扩展开发能力
Golang 生态工具与框架:扩展开发能力

《Golang 生态工具与框架》系统梳理 Go 语言在实际工程中的主流工具链与框架选型思路,涵盖 Web 框架、RPC 通信、依赖管理、测试工具、代码生成与项目结构设计等内容。通过真实项目场景解析不同工具的适用边界与组合方式,帮助开发者构建高效、可维护的 Go 工程体系,并提升团队协作与交付效率。

1

2026.02.24

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.5万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号