Python标识符命名规范

news/2026/1/19 15:51:48/文章来源:https://www.cnblogs.com/aaammm/p/19502104

一、必须遵守的语法规则(违反会直接报错)

标识符是用来给变量、函数、类、模块等命名的字符序列,必须符合以下硬性要求:

  1. 字符组成:只能由字母(A-Z/a-z)、数字(0-9)、下划线(_) 组成,且不能以数字开头
    ✅ 合法示例:nameage18user_name_score
    ❌ 非法示例:18age(以数字开头)、user-name(含减号)、my@email(含特殊符号)、姓名(非ASCII字符,虽部分Python环境能运行,但不推荐)
  2. 大小写敏感:Python对标识符的大小写严格区分。
    示例:Namename 是两个完全不同的标识符,AGEage 也互不相关。
  3. 不能使用关键字:Python的保留关键字(如ifelsefordef等)不能作为标识符。
    可通过以下代码查看所有Python关键字:
    import keyword
    print(keyword.kwlist)
    
    ❌ 错误示例:def = 10def是关键字)、class = "student"class是关键字)

二、推荐遵循的PEP 8风格规范(提升代码可读性)

PEP 8是Python官方的代码风格指南,以下是标识符命名的核心规范,也是行业通用标准:

1. 变量/函数/模块名:小写+下划线(蛇形命名法,snake_case)

  • 核心规则:全部小写,多个单词之间用下划线分隔,简洁易懂。
  • ✅ 示例:
    # 变量
    user_name = "张三"
    student_age = 20
    total_score = 95.5# 函数
    def calculate_average_score(scores):return sum(scores) / len(scores)
    

2. 常量名:全大写+下划线

  • 核心规则:全部大写,多个单词用下划线分隔,用于表示不会修改的常量(Python无真正常量,靠命名约定)。
  • ✅ 示例:
    MAX_RETRY = 3  # 最大重试次数
    PI = 3.1415926  # 圆周率
    DEFAULT_TIMEOUT = 10  # 默认超时时间
    

3. 类名:大驼峰命名法(CamelCase)

  • 核心规则:每个单词首字母大写,无下划线,这是类名的专属规范。
  • ✅ 示例:
    class StudentInfo:  # 学生信息类def __init__(self, name, age):self.name = nameself.age = ageclass OrderProcessing:  # 订单处理类pass
    

4. 私有标识符:单下划线/双下划线开头

  • 单下划线(_xxx):约定俗成的“私有”标识,提示外部不要直接访问(仅靠约定,语法上仍可访问)。
    ✅ 示例:
    def _private_function():  # 私有函数,仅内部使用return "内部数据"class Person:def __init__(self):self._id = 123  # 私有属性
    
  • 双下划线(__xxx):Python会自动做“名称修饰”,真正限制外部访问(避免子类重写或外部调用)。
    ✅ 示例:
    class Person:def __init__(self):self.__password = "123456"  # 强私有属性p = Person()
    print(p.__password)  # 直接访问会报错
    print(p._Person__password)  # 特殊方式可访问(不推荐)
    

三、额外的实用命名建议(新手必看)

  1. 见名知意:避免用无意义的字符(如abx1),名称要体现用途。
    ❌ 不好的示例:s = "张三"n = 20
    ✅ 好的示例:student_name = "张三"student_age = 20
  2. 长度适中:不要过长(如calculate_the_average_score_of_all_students),也不要过短(如avg),兼顾简洁和清晰(推荐calculate_student_avg_score)。
  3. 避免歧义:不要用易混淆的字符,比如l(小写L)、O(大写O)、0(数字0),容易看错。

总结

  1. 语法规则是底线:标识符只能由字母/数字/下划线组成,不能以数字开头、不能用关键字,且大小写敏感;
  2. 风格规范是标配:变量/函数用蛇形命名(snake_case)、常量全大写、类名用大驼峰(CamelCase);
  3. 命名核心原则:见名知意、简洁规范,让自己和他人能快速理解代码含义。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/1183758.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

BEATOZ区块链专业企业与韩国头部旅游集团MODETOUR从签署MOU迈向网络验证节点合作

BEATOZ区块链专业企业与韩国头部旅游集团MODETOUR从签署MOU迈向网络验证节点合作——作为BEATOZ区块链,Web3.0开放平台的核心合作伙伴,发挥连接旅游、金融与技术的桥梁作用。BEATOZ区块链开发企业于19日宣布,韩国代表性综合旅游集团 MODETOUR…

MinerU如何验证提取质量?评估指标与人工校验结合

MinerU如何验证提取质量?评估指标与人工校验结合 1. 引言:复杂文档提取的挑战与MinerU的定位 在当前AI驱动的内容处理场景中,PDF文档作为信息传递的主要载体之一,其结构复杂性(如多栏排版、嵌套表格、数学公式、图文…

2026年权威仪器设备校准/仪器外校/仪器校检/教学仪器校准/实验室通用仪器校准厂家实力推荐榜:CNAS认可实验室服务,专业第三方校准机构精选

面对市场上众多的校准服务供应商,如何选择一家真正可靠、技术过硬且服务规范的第三方校准机构,已成为工业制造、科学研究与教育教学等领域共同关注的核心问题。本文旨在通过客观分析与对比,为您在复杂的市场环境中提…

提升识别准确率的小技巧,万物识别实战经验分享

提升识别准确率的小技巧,万物识别实战经验分享 1. 引言:中文通用图像识别的现实挑战 在当前人工智能技术快速落地的背景下,图像识别已广泛应用于内容审核、智能安防、电商自动化和辅助决策等场景。然而,大多数开源视觉模型依赖英…

2026企业智能升级指南:从Deepseek知识库部署服务商到本地BI私有化方案商全解析 - 品牌2026

在数字化转型加速的2026年,越来越多的企业意识到,传统BI(商业智能)工具已难以满足复杂业务场景下的实时分析、多系统协同与数据安全需求。尤其对于金融、医疗、能源、零售等对数据敏感度高、合规要求严的行业,企业…

Vivado下载失败怎么办?网络与防火墙问题实战案例

Vivado下载失败?别急,先看这篇网络排障实战指南你是不是也遇到过这种情况:项目刚启动,急需安装Vivado进行FPGA开发,结果点击“Download”后进度条卡在10%、30%,甚至直接弹出“Network Error”或“SSL Hands…

2026年福建蚊香液跨境外贸公司推荐:蚊香外贸 /出口电蚊香 /电蚊香跨境出口/ 出口蚊香 /蚊香片跨境出口服务公司精选

在全球驱蚊产品市场中,跨境出口需求持续攀升,消费者对安全、高效、环保的驱蚊产品关注度日益提升。在此背景下,福建小神童日化用品有限公司凭借其多元化产品矩阵和全球化布局,成为行业备受瞩目的企业之一。公司深耕…

HY-MT1.5-7B部署进阶:如何实现高可用翻译服务

HY-MT1.5-7B部署进阶:如何实现高可用翻译服务 随着多语言交流需求的不断增长,高质量、低延迟的翻译服务已成为智能应用的核心能力之一。特别是在全球化业务拓展、跨语言内容生成和实时通信场景中,翻译模型的服务稳定性与响应效率直接影响用户…

救命神器!专科生毕业论文TOP9 AI论文平台测评

救命神器!专科生毕业论文TOP9 AI论文平台测评 专科生毕业论文写作的“救星”:2026年度AI平台测评揭秘 随着高校教育的不断深化,专科生在毕业论文写作过程中面临的挑战日益增多。从选题困难到资料查找,从结构搭建到格式规范&#x…

2026 年主数据管理哪家好?主流公司与优质系统精选推荐 - 品牌2026

数字化转型进入深水区,主数据作为企业核心资产,其标准化、一致性管理已成为打破数据孤岛、驱动智能决策的关键。据IDC调研,超70%中国大型企业已启动主数据治理项目,2026年主数据管理正从“可选配置”升级为“必选底…

Fun-ASR-MLT-Nano-2512语音取证:司法场景应用指南

Fun-ASR-MLT-Nano-2512语音取证:司法场景应用指南 1. 引言 1.1 业务背景与技术需求 在司法实践中,语音证据的采集与分析已成为案件侦办的重要环节。无论是审讯录音、电话监听,还是公共区域的音频记录,如何高效、准确地将语音内…

长治市襄垣平顺黎城壶关英语雅思培训辅导机构推荐,2026权威出国雅思课程中心学校口碑排行榜 - 苏木2025

在全球化留学趋势下,雅思考试已成为长治市襄垣、平顺、黎城、壶关四地学子通往海外名校的关键门槛,但本地雅思培训市场乱象丛生,考生普遍面临诸多困境:优质教育资源稀缺、选课迷茫难以甄别靠谱机构、提分技巧掌握不…

2026年中山二手名包回收公司推荐榜:超奢名品回收黄金手表包包奢侈品,二手包包回收/二手手表回收/二手名表回收/二手黄金回收/回收二手名包/二手金条回收/二手回收二手名表/二手奢侈品回收公司精选

在二手**品回收领域,消费者对专业度、透明度与安全性的需求日益增长。据行业调研数据显示,2025年全国二手**品交易规模突破800亿元,其中黄金、名表、名包等品类占比超65%,但市场仍存在鉴定标准不统一、价格不透明等…

Qwen2.5-0.5B育儿建议:儿童成长指导系统

Qwen2.5-0.5B育儿建议:儿童成长指导系统 1. 技术背景与应用场景 随着人工智能在教育和家庭场景中的深入应用,轻量级大语言模型正逐步成为个性化服务的重要支撑。Qwen2.5-0.5B-Instruct 作为阿里开源的最小参数版本指令模型(0.5B&#xff09…

通义千问+语音识别:声控儿童动物生成系统集成部署案例

通义千问语音识别:声控儿童动物生成系统集成部署案例 1. 引言 随着人工智能技术的不断演进,大模型在内容生成领域的应用日益广泛。特别是在面向儿童的应用场景中,如何通过自然、安全且富有趣味性的方式实现交互式内容生成,成为教…

0.1加0.2为什么不等于0.3

🧑‍💻 写在开头 点赞 + 收藏 === 学会🤣🤣🤣这个问题你可能在面试、线上 Bug、甚至随手写 Demo 的时候都见过:console.log(0.1 + 0.2 === 0.3); // false很多人第一反应是“浮点数精度问题”,但如果继续追…

从布局分析到元素识别|基于PaddleOCR-VL的全流程技术拆解

从布局分析到元素识别|基于PaddleOCR-VL的全流程技术拆解 1. 引言:文档解析的新范式 在数字化转型加速的背景下,文档解析已成为信息提取、知识管理与自动化流程中的关键环节。传统OCR技术多聚焦于文本识别,难以应对现代文档中复…

NewBie-image-Exp0.1与Mochi Diffusion对比:长尾特征生成能力评测

NewBie-image-Exp0.1与Mochi Diffusion对比:长尾特征生成能力评测 1. 引言 1.1 选型背景 在当前AI生成内容(AIGC)领域,动漫图像生成已成为一个高度活跃的技术方向。随着用户对角色细节、风格多样性以及属性控制精度的要求不断提…

小程序毕设选题推荐:基于springboot+微信小程序的考研刷题平台考研复习辅助平台【附源码、mysql、文档、调试+代码讲解+全bao等】

博主介绍:✌️码农一枚 ,专注于大学生项目实战开发、讲解和毕业🚢文撰写修改等。全栈领域优质创作者,博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java、小程序技术领域和毕业项目实战 ✌️技术范围:&am…

如何通过工业智造超级智能体实现汽车制造工厂数字化转型

如何通过工业智造超级智能体实现汽车制造工厂数字化转型技术架构的核心突破工业智造超级智能体正在彻底改变汽车制造业的数字化转型路径。与传统的自动化系统不同,这种智能体采用了一种全新的架构设计——它不仅仅是简单的机器替代人力,而是构建了一个能…