您现在的位置是：首页 > Python

当前栏目

Python 代码注释

Python 程序代码

2023-03-02 14:05:23 时间

## 注释的作用 ##

> 用自己熟悉的语言，在程序中对某些代码进行标注说明，增强程序的可读性。

## 单行注释 ##

*  以 `#` 开头，`#` 右边的所有东西都被当做说明文字，而不是真正要执行的程序，只起到辅助说明作用
 *  示例代码如下：

#!/usr/bin/python3
    # -*- coding:utf-8 -*-
    
    # 这是第一个单行注释
    print("hello python")

> 为了保证代码的可读性，`#` 后面建议 **先添加一个空格**，然后再编写相应的说明文字

**在代码后面增加单行注释**

*  在程序开发时，同样可以使用 `#` 在代码的后面（旁边）增加说明性的文字
 *  但是，需要注意的是，**为了保证代码的可读性**，**注释和代码之间** 至少要有 **两个空格**
 *  示例代码如下：

#!/usr/bin/python3
    # -*- coding:utf-8 -*-
    
    print("hello python")  # 输出 `hello python`

## 多行注释 ##

*  如果希望编写的 **注释信息很多，一行无法显示**，就可以使用多行注释
 *  要在 Python 程序中使用多行注释，可以用 **一对 连续的 三个 引号**(单引号和双引号都可以)
 *  示例代码如下：

#!/usr/bin/python3
    # -*- coding:utf-8 -*-
    
    # 使用多个单行注释来多行注释
    # 输入 hello world
    print('hello world')
    
    """ 这是一个多行注释 在多行注释之间，可以写很多很多的内容…… """ 
    print("hello python")

## 什么时候需要使用注释？ ##

1.  **注释不是越多越好**，对于一目了然的代码，不需要添加注释
2.  对于 **复杂的操作**，应该在操作开始前写上若干行注释
3.  对于 **不是一目了然的代码**，应在其行尾添加注释（为了提高可读性，注释应该至少离开代码 2 个空格）
4.  绝不要描述代码，假设阅读代码的人比你更懂 `Python`，他只是不知道你的代码要做什么

> 养成写注释的习惯，让自己、让同事、让借鉴者有着更好的代码阅读体验。

## 关于代码规范 ##

*  `Python` 官方提供有一系列 ***PEP（Python Enhancement Proposals）*** 文档
 *  其中第 **`8`** 篇文档专门针对 **Python 的代码格式** 给出了建议，也就是俗称的 **PEP 8**
 *  文档地址：https://www.python.org/dev/peps/pep-0008/
 *  谷歌有对应的中文文档：http://zh-google-styleguide.readthedocs.io/en/latest/google-python-styleguide/python\_style\_rules/

> 任何语言的程序员，编写出符合规范的代码，是开始程序生涯的第一步。

## 尾语 ##

**✍ 用 Code 谱写世界，让生活更有趣。❤️**

**✍ 万水千山总是情，点赞再走行不行。❤️**

**✍ 码字不易，还望各位大侠多多支持。❤️**

![008.jpg][]

[008.jpg]: /images/20221014/af35dbe7abde412d80dc36694f7f5826.png

猜你喜欢

鲜为人知但很有用的 HTML 属性
在 Go 里用 CGO？这 7 个问题你要关注！
数据孤岛是业务效率的无声杀手
9款优秀的去中心化通讯软件 Matrix 的客户端
翻转再翻转！有意思的水平横向溢出滚动
发现 Linux SpaceFM 文件管理器的威力
图像处理工具Python扩展库，你了解吗？
求职数据分析，项目经验该怎么写
自定义计数器小技巧！CSS 实现长按点赞累加动画
在OKR中，我看到了数据驱动业务的未来
2023展望：新的一年将给大数据分析领域带来什么？
过五关！React高频面试题指南
阿里云ADB基于Hudi构建Lakehouse的实践
火山引擎云原生大数据在金融行业的实践
OpenHarmony富设备移植指南（二）—从postmarketOS获取移植资源
《数据成熟度指数》报告：64%的企业领袖认为大多数员工“不懂数据”
OpenHarmony 小型系统兼容性测试指南
肯睿中国（Cloudera）：2023年企业数字战略三大趋势预测
适用于 Linux 的十大命令行游戏
软件开发中的十个认知偏差

zl程序教程

当前栏目

Python 代码注释

相关文章