第二单元 2.4 体会程序编写规范：命名与注释（课件）-《Python程序设计基础》（高等教育出版社）同步精品课堂

第二单元 2.4 体会程序编写规范：命名与注释 Python程序设计基础 同步精品课堂 高等教育出版社 任务一 注释与缩进 任务二 空行与多行语句 任务三 实战纠错与编码 掌握国家标准《机械制图》中有关图幅、比例、字体图线等基本规定。 教学目标 一 1、掌握注释的作用与不同写法 2、掌握代码缩进作用与使用 3、了解空行与多行语句的写法 教学重难点 二 教学重点： 1、注释的不同写法 2、代码缩进的作用与使用 教学难点： 代码缩进的作用与使用 导入新课 三 下面两段代码实现的是同一个功能，哪段代码更好？为什么？ 今天我们将一起学习程序的编写规范，将程序写得“更漂亮”！ 任务一 注释与缩进 机位固定：摄像机本身不移动（如不推、拉、摇、移）。 新知讲授 四 1、注释的基本概念与作用 注释是程序代码中的解释性文字，用于对代码进行说明和描述。就像产品的使用说明书一样，注释帮助开发者理解代码的功能和设计意图。注释内容会被Python解释器完全忽略，不会影响程序运行，也不会出现在运行结果中。 注释还可以用于临时注释掉不想执行的代码，选中代码，按Ctrl+/组合键可将选中的代码注释或取消注释。 提高可读性 让其他开发者（或未来的自己）能够快速理解代码逻辑。 代码说明 解释复杂算法、业务逻辑或特殊处理的原因。 调试辅助 临时禁用部分代码而不删除。 团队协作 统一团队对代码功能的理解。 机位固定：摄像机本身不移动（如不推、拉、摇、移）。 新知讲授 四 2、注释的类型与语法规范 ①单行注释：以 # 符号开头，从 # 开始到行尾的所有内容都是注释，可以独立成行，也可以放在代码行尾。 多行代码说明：将注释放在代码块上方。 单行代码说明：将注释放在代码行右侧 复杂逻辑说明：在关键步骤前添加注释 示例 机位固定：摄像机本身不移动（如不推、拉、摇、移）。 新知讲授 四 2、注释的类型与语法规范 ②多行注释：使用三个单引号 ''' 或三个双引号 """ 包裹，开始和结束标记必须成对出现，中间可以包含多行文字。 多行注释通常用来为Python的文件、模块、类或者函数等添加版权、功能描述等信息。 示例 注意：在Python中，如果”’’’”作为语句的一部分出现，就不能再将它们视为多行注释的标记，而应看作字符串。 机位固定：摄像机本身不移动（如不推、拉、摇、移）。 新知讲授 四 3、注释的使用规范 简明扼要：注释应该简洁明了，避免冗长 说明原因：不仅要说明"做什么"，还要说明"为什么" 及时更新：代码修改时，相关注释也要同步更新 避免废话：不要写显而易见的注释 单行注释：# 后保留一个空格，注释文字与代码保持适当对齐 多行注释：保持整齐的缩进和格式 中文注释：在中文环境下可以使用中文注释，但要保持统一 内容规范 格式规范 机位固定：摄像机本身不移动（如不推、拉、摇、移）。 新知讲授 四 4、缩进的基本概念与重要性 缩进是指在代码行前添加空格或制表符，使代码在视觉上产生层次结构。在Python中，缩进不是可选的代码风格，而是语法的一部分。 Python是少数将缩进作为语法要求的编程语言，因此常被戏称为"需要拿着游标卡尺学习的语言"。 定义代码块 代替其他语言中的大括号 { }。 表示逻辑层次 清晰展示代码的执行范围。 增强可读性 使代码结构一目了然。 强制代码规范 统一团队的编码风格。 机位固定：摄像机本身不移动（如不推、拉、摇、移）。 新知讲授 四 5、缩进的语法规范 python采用代码缩进和冒号来区分代码块之间的层次。缩进的空格数是可变的，一般是4个空格、8个空格或1个制表符。但是同一个代码块的语句必须包含相同的缩进空格数。 推荐的缩进方式： 4个空格：Python官方推荐，大多数项目的标准 1个制表符：部分项目使用，但不建议与空格混用 不推荐的缩进方式： 2个空格（过小，层次不明显） 8个空格（过大，代码行过长） 机位固定：摄像机本身不移动（如不推、拉、摇、移）。 新知讲授 四 5、缩进的语法规范 虽然Python允许不同的缩进量，但必须遵循一致性原则：同一个代码块的语句必须包含相同的缩进空格数。如果随意地缩进代码，Python解释器就会报错。 正确示例 错误示例 任务二 空行与多行语句 新知讲授 四 1、空行的作用与使用规范 空行是指代码文件中不包含任何代码（包括注释）的空白行。虽然空行不是Python语法的一部分，但在实际开发中具有重要作用。 函数/类之间：用2个空行分隔 不同逻辑块之间：用1个空行分隔 导入语句与代码之间：用1-2个空行分隔 新知讲授 四 1、空行的作用与使用规范 不要过度使用：过多的空行会分散注意力 保持一致性：在项目中统一空行使用规范 不影响执行：空行不会影响程序运行性能 错误使用空行示例 新知讲授 四 2、多行语句的使用方法 ①如果语句很长，使用反斜杠（\）续行，其语法如下： ②在[ ]、{ }、( )内直接换行，不需要使用反斜杠，其语法如下： 新知讲授 四 3、在同一行显示多条语句 Python可以在同一行中使用多条语句，语句之间用英文分号”;”分隔，其语法如下： 注意：过于复杂的多语句不推荐在同一行显示，应该写成多行 任务三 实战纠错与编码 新知讲授 四 注释打断语句 1、常见错误类型——①注释相关错误及规范 多行注释标记不匹配 新知讲授 四 在需要缩进的代码块后缺少缩进 1、常见错误类型——②缩进相关错误及规范 出现了不必要的缩进 新知讲授 四 缩进级别不一致 1、常见错误类型——②缩进相关错误及规范 混合使用制表符和空格 新知讲授 四 语法错误，如关键字拼写错误、缺少符号等 1、常见错误类型——③语法相关错误及规范 使用了非法字符，如中文标点 新知讲授 四 仔细阅读错误信息：定位错误类型和位置 检查拼写：确认关键字、变量名拼写正确 验证缩进：检查代码块缩进是否正确一致 检查符号：确认括号、引号、冒号等配对正确 检查编码：避免使用中文标点符号 2、遇到错误时的排查步骤 新知讲授 四 例1：找出下列程序中的错误代码 3、实战纠错与编码 第3、4、6行：if和else代码块缺少缩进 第7行：不必要的缩进（与else不对齐） 第2、5行：if和else应该对齐 新知讲授 四 例2：找出下列程序中的错误代码 3、实战纠错与编码 第4行：变量名student_Age大小写错误，应为student_age 第4行：字符串连接时年龄是数字，需要转换为字符串 新知讲授 四 例3：找出下列程序中的错误代码 3、实战纠错与编码 第6、7、9行：print语句中变量前缺少逗号 第8行：数学运算顺序错误，应该是(a + b + c) / 3 代码逻辑：没有考虑运算优先级 师生互动 五 1、注释有什么作用 2、注释有哪些类型 3、空行有什么作用 答案： 1、注释是程序代码中的解释性文字，用于对代码进行说明和描述。 2、注释有单行注释和多行注释两种。 3、空行可以分隔两段不同功能或含义的代码，便于日后代码的维护或重构。 随堂练习 六 1 、以下（ ）是多行注释的正确写法。 A./* 注释内容 */ B.// 注释内容 // C.''' 注释内容 ''' D.<- 注释内容 -> 答案：C 解析：Python中多行注释使用三个单引号或三个双引号。 随堂练习 六 2 、如果出现"expected an indented block"错误，可能的原因是（ ） A.变量名写错 B.缺少冒号 C.循环体没有缩进 D.使用了中文括号 答案：C 解析：该错误提示表示在需要缩进的代码块处没有找到缩进。 随堂练习 六 3 、如果for语句后面缺少冒号，会导致（ ）。 A.NameError B.SyntaxError C.IndentationError D.TypeError 答案：B 解析：缺少冒号属于语法错误，会引发SyntaxError。 随堂练习 六 4 、关于空行的作用，下列说法正确的是（ ）。 A.空行是语法必需 B.空行会导致错误 C.空行分隔不同功能代码 D.空行会被解释器执行 答案：C 解析：空行用于分隔不同功能或含义的代码，便于维护。 随堂练习 六 5 、（多项选择题）关于Python缩进，以下说法正确的有（ ）。 A.同一代码块缩进必须相同 B.缩进空格数可以任意 C.缩进表示代码层次关系 D.缩进错误会导致程序无法运行 答案：ACD 解析：缩进空格数虽然可变，但在同一项目中应该保持一致。 随堂练习 六 6 、（多项选择题）以下（ ）情况会导致SyntaxError。 A.使用中文括号 B.关键字拼写错误 C.缺少冒号 D.变量未定义 答案：ABC 解析：变量未定义导致NameError，其他都会导致SyntaxError。 随堂练习 六 7、(是非选择题)空行是Python语法的一部分。 A.正确 B.错误 答案：B 解析：空行不是语法必需，但有助于代码可读性。 随堂练习 六 8、(是非选择题)多行注释不能作为字符串使用。 A.正确 B.错误 答案：B 解析：三个引号既可以作为多行注释，也可以定义多行字符串。 随堂练习 六 9、 是编写程序时不可或缺的一部分，它能准确反映代码的 、目的以及可能的 ，为后续代码审查、修改和 提供便利。 答案：注释 功能 复杂逻辑 维护 解析：注释是编写程序时不可或缺的一部分，它能准确反映代码的功能、目的以及可能的复杂逻辑，为后续代码审查、修改和维护提供便利。 课堂小结 七 谢谢 $