初识Python(注释、编码规范、关键字...)

🥇作者简介:CSDN内容合伙人、新星计划第三季Python赛道Top1
🔥本文已收录于Python系列专栏: 零基础学Python
💬订阅专栏后可私信博主进入Python学习交流群,进群可领取Python视频教程以及Python相关电子书合集
私信未回可以加V:hacker0327 备注零基础学Python
在这里插入图片描述

订阅专栏附赠此专栏思维导图,可直接点击链接跳转学习
在这里插入图片描述

零基础学Python系列专栏面向零基础读者倾心打造,永久免费订阅,一个专栏带你吃透Python,旨在帮助初学者从零开始学习Python
从搭建环境、基础语法入手到深入学习掌握各种核心库和框架,学习利用Requests、Beautiful Soup、Scrapy等库从网络上获取数据、利用Pygame库进行游戏开发、利用NumPy、Pandas、Matplotlib等库进行数据分析,数据可视化、利用Django、Flask框架构建网站和Web应用程序等等,最终掌握并应用于实际项目。学习不断,持续更新,火热订阅中🔥
在这里插入图片描述

初识Python

  • 💬注释
    • 单行注释
    • 多行注释
    • 文件注释
    • 文档注释
    • 代码注释
    • TODO注释
  • 💬代码缩进
  • 💬标识符命名规范
  • 💬编码规范
  • 💬变量与常量
    • 变量
    • 常量
  • 💬Python关键字
    • 关键字简介
    • 查看Python关键字
  • import与from...import...
    • import
    • from...import...
  • 💬结束语

💬注释

单行注释

在Python中使用"#“作为单行注释的符号,从符号”#“开始直到换行为止,”#"后面所有的内容都作为注释内容,同时注释内容会被Python编译器忽略
单行注释可以放在要注释代码的前一行,也可放在要注释代码的右侧

💬第一种方式

# 输出hello world
print("hello world")  

💬第二种方式

print("hello world")  # 输出hello world

上面两种方式运行结果如下:

在这里插入图片描述

多行注释

在Python中,使用三对单引号或者三对双引号进行多行注释,推荐使用三对双引号进行多行注释
多行注释通常为Python文件、模块、类或者函数等添加版权、功能等信息
多行注释主要还是用作字符串,在后面的文章讲解字符串的时候会讲到

💬第一种方式(不推荐)

'''
这是一个多行注释
单引号包裹的部分会被Python解释器忽略
输出hello world
'''
print("hello world")

当使用三对单引号进行多行注释时,Pycharm会显示出来灰色波浪线,虽然不影响代码运行,但很影响程序美观。当代码下面出现波浪线时,通常表示代码存在一些警告或者建议

在这里插入图片描述

我们可以将鼠标悬停在波浪线上查看相应信息,根据提示修改即可
详细解决方案见此文章:Triple double-quoted strings should be used for docstrings.

在这里插入图片描述

💬第二种方式(推荐)

"""
这是一个多行注释
双引号包裹的部分会被Python解释器忽略
输出hello world
"""
print("hello world")

上面两种方式运行结果如下:

在这里插入图片描述

文件注释

文件注释通常放在文件开头,用于描述文件的内容、功能、作者信息以及其他相关信息 在文件注释中,通常包括以下信息

  • 模块名:模块的名称
  • 描述:文件的用途
  • 作者信息:作者的姓名或者用户名
  • 日期:文件创建或最后修改的日期

除了这些基础信息外,文件注释还可以包括其他相关信息,例如版权声明、许可证信息、文件版本等。
良好的文件注释可以帮助其他开发者更好地理解和使用代码,特别是在大型项目或者团队合作的情况下,它们是非常有价值的。

以下是一个典型的Python文件注释示例:

"""
模块: 初识Python.py
描述: 讲解Python基础知识,包括输出、变量、运算符等
作者: hacker707
日期: 2024-04-09
"""
print("hello world")  # 输出hello world
a = 10  # 定义变量a
b = 20  # 定义变量b
print(a + b)  # 输出a + b的值

文档注释

在Python中,文档注释(docstrings)是用来描述函数、类、模块等代码单元的文本。这些注释以三对单引号 ‘’’ 或者三对双引号’‘’‘’'包裹起来,推荐使用三对双引号''''''
可以跨越多行,并且可以被Python解释器识别为文档字符串。文档注释可以通过__doc__属性进行访问。
文档注释的主要目的是提供有关代码单元的使用方法、功能说明、参数说明、返回值说明等信息。这些信息可以被工具和IDE用来提供代码提示、文档查看等功能,也可以用于自动生成文档。

以下是一个简单的函数文档注释示例:

def calculate_area(inner_radius):"""计算圆的面积该函数接受一个半径值作为参数,并返回对应圆的面积。参数:inne_radius (float): 圆的半径值,必须为非负实数。返回:float: 圆的面积,以平方单位表示。"""if inner_radius < 0:raise ValueError("半径值必须为非负实数")return 3.14159 * inner_radius ** 2# 使用示例
outer_radius = 5.0
area = calculate_area(outer_radius)
print("圆的面积:", area)

在这个示例中,文档注释清晰地描述了函数的功能、参数和返回值,以及参数的数据类型。
良好的文档注释可以提高代码的可读性和可维护性,让其他开发者更容易理解和使用你的代码。

运行结果如下:
在这里插入图片描述

代码注释

代码注释是给阅读源代码的人参考的,起到解释说明,帮助阅读者理解代码功能的作用 ,一般使用单行或者多行注释

在这里插入图片描述

TODO注释

在 PyCharm 中,TODO 注释是一种特殊类型的注释,用于标记代码中需要完成或者需要注意的任务。这些注释通常用于标记临时的、尚未完成的工作,或者需要后续处理的问题,以便开发者可以方便地找到并跟踪这些任务。
通常,TODO 注释以 TODO: 开头,后面跟着任务的描述或者说明。在 PyCharm 中,TODO 注释通常会被特殊地高亮显示,以便开发者更容易地识别它们。

以下是一个示例 TODO 注释:

# TODO: 1. 输出hello world
print("hello world")
# TODO: 2. 使用for循环分别输出a字符串中每个字符
a = "hello world"
for i in a:print(i)

通过在代码中添加 TODO 注释,开发者可以快速识别出需要处理的任务,并在后续的开发过程中进行跟踪和处理。PyCharm 还提供了工具和功能,可以让开发者方便地查看项目中所有的 TODO 注释,并跳转到相应的位置进行处理。这有助于提高代码的可维护性和开发效率。

可以在View—>Tool Windows中点击TODO即可进入TODO视图界面

在这里插入图片描述

我的图标与默认的不同是因为使用了PyCharm里的一个美化图标的插件,感兴趣的可以看以下文章自行探索:
PyCharm使用指南(个性化设置、开发必备插件、常用快捷键)

也可以在Pycharm左下角点击TODO视图图标即可打开TODO视图界面

在这里插入图片描述

点击即可跳转至相应的TODO注释位置

在这里插入图片描述

💬代码缩进

Python不像其他程序设计语言(如Java或者C语言)采用大括号"{}"来分隔代码块,而是采用代码缩进来区分代码之间的层次。Python 的语法规定,代码块之间的缩进必须保持一致.
注意事项:缩进可以使用空格或者Tab键实现,其中,使用空格时,通常情况下采用4个空格作为一个缩进单位,而使用tab键,则采用一个Tab键作为一个缩进单位。通常情况下建议采用空格进行缩进。

num = 10if num > 5:print("num is greater than 5")else:print("num is not greater than 5")print("This line is outside the if-else block")

在这里插入图片描述
代码讲解(通过讲解代码来了解代码缩进级别)

以上代码实现的功能是当num的值大于5也就是符合条件时输出num is greater than 5,否则输出num is not greater than 5
这段代码中红色块、蓝色块分别表示一个缩进级别,同一个级别缩进量必须相同。如果同级缩进量不同就会报错,详细报错解决方案见此文章::IndentationError: expected an indented block
num的值大于5,满足条件所以会执行if代码块中的print语句,而else代码块中的print语句不会执行。在这段代码中还有一个print语句也会执行,因为该代码块和最外层缩进一样,属于最外层的代码,无论符不符合条件都会执行
在这里插入图片描述

💬标识符命名规范

在Python中,标识符是用来命名变量、函数、类以及其他对象的名称。 以下是Python标识符的命名规范:

  • 标识符可以包含字母(大小写均可)、数字和下划线
  • 标识符不能以数字开头
  • 标识符不能包含空格,可以使用下划线 _ 来分隔单词
  • 标识符不能使用Python中的关键字
  • 标识符不能使用Python中的内置函数
  • Python是区分大小写的,因此大写字母和小写字母被视为不同的标识符

遵循这些命名规范可以使你的代码更易读、易维护,并且与Python社区的约定保持一致。

❎错误示例:

1variable = 10  # 使用数字开头
my variable = 10 # 使用空格
my@variable = 10 # 使用特殊字符
if = 10 # 使用关键字
max = 10 # 使用内置函数

✅正确示例:

variable_name = 10  # 包含字母和下划线,但不以数字开头
my_variable1 = 10  # 包含字母、数字和下划线,但不以数字开头
_variable = 10  # 包含字母和下划线,以下划线开头
variable1 = 10  # 包含字母和数字,但不以数字开头

💬Python 的标识符命名规范通常包括以下几种分类:

  • 变量名:用于标识存储数据的名称。变量名应当具有描述性,清晰地表达所代表的含义,变量名通常使用蛇形命名法
    ✨示例:my_variable、num_of_students、total_sum
  • 常量名:用于标识不可变的值,通常在程序中固定不变。变量名通常使用大写字母,使用下划线分割单词
    ✨示例:PI 、DEFAULT_TIMEOUT、MAX_SIZE
  • 函数名:用于标识可调用的代码块,执行特定任务或操作数据,函数名应当具有描述性,函数名通常使用蛇形命名法
    ✨示例:calculate_total 、display_results 、get_user_input
  • 类名:用于定义对象类型,类名通常使用驼峰命名法
    ✨示例:Student 、FetchUserDetailsFromDatabase 、generateRandomNumber
  • 模块名:用于组织代码,并将相关功能组织成单个单元,模块名应当简介明了,使用小写字母,使用下划线分割单词
    ✨示例:math 、random、requests

遵循这些命名规范可以使你的代码更易读、易维护,并且与Python社区的约定保持一致。

💬编码规范

Python中采用PEP8作为编码规范,官方详细参考文档:https://peps.python.org/pep-0008/
下面列出一些需要严格遵守的编码规范

  • 每个import语句只导入一个模块,尽量避免一次导入多个模块
    推荐写法:import math
  • 不要在行尾添加;
  • 每行代码建议不超过79个字符,如果超过,可以使用()将多行内容连接起来
    ✨示例:
motto = ("不断的翻越一座又一座的高山,那样的人生才是我想要的。""这一马平川,一眼见底的活,我不想要。我的人生,我自己书写""余生很长,请多关照,我的人生,敬请期待")

💬变量与常量

变量

变量是用来存储数据值的标识符。
在 Python 中,变量不需要显式声明类型,可以直接进行赋值操作。
变量的值可以随时被改变。
变量名是由字母、数字和下划线组成,但不能以数字开头。

✨示例:

x = 5  # 将整数值 5 赋给变量 x
name = "Alice"  # 将字符串值 "Alice" 赋给变量 name

常量

在 Python 中,没有严格的常量概念,因为 Python 不提供内置的常量类型。
通常,程序员会使用全大写字母命名的变量来表示常量,表示这个变量的值不应该被修改。
尽管 Python中的常量并不是真正意义上的常量,但这种命名约定有助于提高代码的可读性和维护性。

✨示例:

PI = 3.14159  # 表示圆周率的常量,通常使用全大写字母命名
MAX_SIZE = 100  # 表示最大尺寸的常量,通常使用全大写字母命名

总之,变量是可变的、可以被赋予不同值的标识符,而常量是不可变的,通常通过使用全大写字母命名的变量来表示。

💬Python关键字

关键字简介

关键字是Python语言中被赋予特殊含义的单词,开发程序时,不可以把这些关键字作为变量、函数、类、模块、和其他对象的名称来使用
如果使用关键字进行命名会报以下异常:SyntaxError: invalid syntax:语法错误

在这里插入图片描述

在Python3.12.2版本中,一共有35个关键字,如下表所示
False、None、True首字母为大写,其他关键字为小写

FalseNoneTrueandasassertasync
awaitbreakclasscontinuedefdelelif
elseexceptfinallyforfromglobalif
importinislambdanonlocalnotor
passraisereturntrywhilewithyield

查看Python关键字

如果想要查看Python中所有的关键字可以使用以下代码进行查看

import keyword  # 引入关键字模块print(keyword.kwlist)  # 打印关键字列表

在这里插入图片描述

如果想要依次输出关键字可以使用列表中的for循环和enumerate()函数遍历(后面讲解列表的时候会讲到,这里仅作了解即可)

import keyword  # 引入关键字模块# 输出所有关键字
for index, key in enumerate(keyword.kwlist):# 输出序号和关键字print(index + 1, key)

在这里插入图片描述

import与from…import…

import

1️⃣使用import语句导入整个模块,然后通过模块名访问其中的对象
✨示例:

import math  # 导入math模块print(math.pi)  # 输出圆周率

2️⃣导入整个模块并使用别名
✨示例:

import math as m  # 导入math模块并重命名为mprint(m.pi)  # 输出圆周率

from…import…

1️⃣导入模块中单个对象
✨示例:

from math import pi  # 导入math模块中的piprint(pi)  # 输出圆周率

2️⃣导入模块中多个对象
✨示例:

from math import pi, sqrt  # 导入math模块中的pi和sqrt函数print(pi, sqrt(100))  # 输出圆周率和100的平方根

3️⃣导入模块中所有对象(不推荐)

这样会导入 math 模块中的所有对象到当前命名空间。不推荐在实际开发中使用,因为可能导致命名冲突和代码可读性问题。

✨示例:

from math import *

💬结束语

以上就是零基础学Python之初识Python(注释、编码规范、关键字…)

  • 专栏订阅地址: https://blog.csdn.net/xqe777/category_12252384.html
  • 专栏订阅者可私信博主领取专栏订阅福利,进入Python学习交流群,如私信未回可以加V:hacker0327 备注零基础学Python
  • 此专栏内容会持续更新直到完结为止(如有任何纰漏请在评论区留言或者私信)

在这里插入图片描述

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

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

相关文章

最新剧透前沿信息GPT-5或将今年发布

GPT2 很糟糕 &#xff0c;GPT3 很糟糕 &#xff0c;GPT4 可以 &#xff0c;但 GPT5 会很好。 PS:GPT2 很糟糕,3 很糟糕,4 可以,5 很可以。 如果想升级GPT4玩玩&#xff0c;地址 今年发布的具有推理功能的 GPT5不断发展&#xff0c;就像 iPhone 一样 Sam Altman 于 17 日&am…

【MATLAB高级编程】第二篇 | 元胞数组(cell)操作

【第二篇】元胞数组&#xff08;cell&#xff09;操作 1. 创建元胞数组cell2. 查看和修改cell内的元素值3. 高级操作: 可视化作图显示cell内的内容4. 把矩阵转换成单元数组5. 把单元数组转换成结构体变量 你好&#xff01; 欢迎进入 《MATLAB高级编程》 文章系列 &#xff0c;每…

Linux基础篇:Linux第三方软件仓库——可以让Linux变得有趣的软件仓库

Linux第三方软件仓库——可以让Linux变得有趣的软件仓库 一、epel源介绍 EPEL&#xff08;Extra Packages for Enterprise Linux&#xff09;源是一个由Fedora项目组维护的第三方软件仓库&#xff0c;为企业级Linux发行版&#xff08;如Red Hat Enterprise Linux&#xff08;…

IDEA中连接SQLserver数据库(DataGrip相同连接)

IDEA中连接SQLserver数据库(DataGrip相同连接) 1. 打开IDEA-database组件 2. 新建SQL server连接 3. 填写信息进行连接 填写连接名称&#xff0c;连接主机IP&#xff0c;端口&#xff0c;默认端口1433&#xff0c;数据库用户名密码&#xff0c;默认数据库用户名是sa 第一次连接…

(学习日记)2024.04.09:UCOSIII第三十七节:事件函数接口

写在前面&#xff1a; 由于时间的不足与学习的碎片化&#xff0c;写博客变得有些奢侈。 但是对于记录学习&#xff08;忘了以后能快速复习&#xff09;的渴望一天天变得强烈。 既然如此 不如以天为单位&#xff0c;以时间为顺序&#xff0c;仅仅将博客当做一个知识学习的目录&a…

Macos 部署自己的privateGpt(2024-0404)

Private Chatgpt 安装指引 https://docs.privategpt.dev/installation/getting-started/installation#base-requirements-to-run-privategpt 下载源码 git clone https://github.com/imartinez/privateGPT cd privateGPT安装软件 安装&#xff1a; Homebrew /bin/bash -c…

【Linux】磁盘与文件系统管理

目录 一、 磁盘结构 1. 数据结构 2. 物理结构 3. 硬盘的接口类型 二、 如何使用Linux中的磁盘 三、 文件系统 四、 磁盘分区 1. MBR分区 2. 分区的优缺点 3. 磁盘及分区的管理工具 五、格式化与挂载 1. 格式化 2. 挂载 六、实例演示 1. 演示分区格式化挂载 2. …

CICD流水线 发布应用到docker镜像仓库

准备工作 1.先注册免费的镜像仓库 复制链接: https://cr.console.aliyun.com/cn-beijing/instances 实施 1. 新建流水线&#xff0c;选择模板 2.添加流水线源&#xff0c;及是你的代码仓库, 选择对应分支. 3.代码检查以及单元测试&#xff0c;这个步骤可以不用动它. 4. …

【Android】App通信基础架构相关类源码解析

应用通信基础架构相关类源码解析 这里主要对Android App开发时&#xff0c;常用到的一些通信基础类进行一下源码的简单分析&#xff0c;包括&#xff1a; Handler&#xff1a;处理器&#xff0c;与某个Looper&#xff08;一个线程对应一个Looper&#xff09;进行关联。用于接…

基于SpringBoot+Vue的大学生体质测试管理系统(源码+文档+部署+讲解)

一.系统概述 大学生体质测试管理系统提供给用户一个简单方便体质测试管理信息&#xff0c;通过留言区互动更方便。本系统采用了B/S体系的结构&#xff0c;使用了java技术以及MYSQL作为后台数据库进行开发。系统主要分为系统管理员、教师和用户三个部分&#xff0c;系统管理员主…

四级作文模板——议论文——现象解释

议论文类型 现象解释 第一句 with the rapid development of society / economy / education / technology / culture / medical / service(任选) , it is of great necessity for youngster / students to improve our speaking ability.随着社会/经济/教育/科技/文化/医疗…

redis 集群模式(redis cluster)介绍

目录 一 redis cluster 相关定义 1&#xff0c; redis cluster 是什么 2&#xff0c;redis 集群的组成 3&#xff0c;集群的作用 4&#xff0c;集群架构图 二 Redis集群的数据分片 1&#xff0c;哈希槽是什么 2&#xff0c;哈希槽如何排布 3&#xff0c;Redis集…

Economic Census

Economic Census 经济普查&#xff0c;企业需提交文档&#xff08;1-6&#xff09;&#xff0c;或者汇总扫描提交

【Spring Cloud Alibaba】9 - OpenFeign集成Sentinel实现服务降级

目录 一、简介Sentinel 是什么如何引入Sentinel 二、服务搭建1.安装Sentinel控制台1.1 下载1.2 启动1.3 访问 2.改造服务提供者cloud-provider服务2.1 引入依赖2.2 添加API2.3 添加配置文件 3.改造cloud-consumer-feign服务3.1 引入依赖3.2 添加Feign接口3.3 添加服务降级类3.4…

2023.4.7 机器学习周报

目录 引言 Abstract 文献阅读 1、题目 2、引言 3、过去方案和Motivation 4、Segment Anything模型 5、创新点 6、实验过程 7、实验结果 1、评价绩效 2、检测评价 3、跟踪评价 8、 结论 总结 引言 本周阅读了一篇关于高效的任意分割模型的文献&#xff0c;用于自…

Splunk Attack Range:一款针对Splunk安全的模拟测试环境创建工具

关于Splunk Attack Range Splunk Attack Range是一款针对Splunk安全的模拟测试环境创建工具&#xff0c;该工具完全开源&#xff0c;目前由Splunk威胁研究团队负责维护。 该工具能够帮助广大研究人员构建模拟攻击测试所用的本地或云端环境&#xff0c;并将数据转发至Splunk实例…

Pytest插件pytest-selenium-让自动化测试更简洁

在现代Web应用的开发中&#xff0c;自动化测试成为确保网站质量的重要手段之一。而Pytest插件 pytest-selenium 则为开发者提供了简单而强大的工具&#xff0c;以便于使用Python进行Web应用的自动化测试。本文将深入介绍 pytest-selenium 插件的基本用法和实际案例&#xff0c;…

达梦数据库的V$DM_INI和V$PARAMETER系统视图

V$DM_INI和V$PARAMETER是达梦数据库中两个常用的系统视图&#xff0c;用于查看数据库的配置参数。这两个视图的主要区别在于它们展示参数的来源和用途。 V$DM_INI V$DM_INI视图主要用于展示数据库启动时加载的初始化参数信息。这些信息通常来自于数据库的初始化参数文件&…

VSCode+Cmake 调试时向目标传递参数

我有一个遍历文件层次结构的程序&#xff0c;程序根据传入的文件路径&#xff0c;对该路径下的所有文件进行遍历。这个程序生成一个名为 ftw 的可执行文件&#xff0c;如果我要遍历 /bin 目录&#xff0c;用法为&#xff1a; ftw /bin问题是&#xff0c;如果我想单步跟踪&…

docker + miniconda + python 环境安装与迁移(简化版)

本文主要列出从安装dockerpython环境到迁移环境的整体步骤。windows与linux之间进行测试。 详细版可以参考&#xff1a;docker miniconda python 环境安装与迁移&#xff08;详细版&#xff09;-CSDN博客 大概过程手绘了一下&#xff1a; 一、docker 安装 略过&#xff0c…