python代碼注釋 - python基礎入門(4)

本文轉載自查看原文 2019-10-05 14:16 485 python多行注釋/ python/ 1.python基礎/ 猿說python/ python教程/ python注釋

在 python改變世界,從hello world開始中我們已經完成了第一個python程序，代碼是有了，關鍵是好像好不知道寫的啥玩意？

python代碼不明白是什么意思

一.什么是代碼注釋

代碼注釋就是給一段代碼加上說明，表明這段代碼的作用或者實現的功能，方便別人閱讀代碼。打個形象的比喻：

問題來了，那個女孩是誰？張三？李四？王五？

加上注釋再來一遍：放開小紅。大家就都明白了，這個女孩叫小紅。

二.為什么寫代碼要注釋

IT圈有一個梗：當我寫這段代碼的時候,只有上帝和我知道,現在,只有上帝知道。上帝說：這個鍋我不背！

IT圈有一句話：提交代碼不寫注釋的人，小JJ就跟注釋一樣長。一個團隊開發時候可能是多個人同時接管一個項目，注釋都沒有，誰知道你寫的什么玩意？

三.python代碼注釋的幾種方式

1.單行注釋，使用英文符號 #

# python注釋代碼 1 
# python注釋代碼 2 
# python注釋代碼 3 
# python注釋代碼 4

2.多行注釋

方法一：英文狀態下使用單引號 ''''''

'''
python注釋代碼 1 
python注釋代碼 2 
python注釋代碼 3 
python注釋代碼 4 
'''

方法二：英文狀態下使用雙引號 """""" (和方法一有點類似)

"""
python注釋代碼 1 
python注釋代碼 2 
python注釋代碼 3 
python注釋代碼 4
"""

方法三：選中單行或者多行，使用快捷鍵 Ctrl+/

# python注釋代碼 1 
# python注釋代碼 2
# python注釋代碼 3 
# python注釋代碼 4

四.回到第一個python項目-helloworld

 1 # !usr/bin/env python
 2 # -*- coding:utf-8 _*-
 3 """
 4 @Author:何以解憂
 5 @Blog(個人博客地址): shuopython.com
 6 @WeChat Official Account(微信公眾號)：猿說python
 7 @Github:www.github.com
 8  
 9 @File:helloworld.py
10 @Time:2019/9/12 20:37
11  
12 @Motto:不積跬步無以至千里，不積小流無以成江海，程序人生的精彩需要堅持不懈地積累！
13 """
14 print("hello word")

上面程序代碼一共15行，其中前面的14行都是注釋，值得注意的是：被注釋的代碼，程序在執行的時候會直跳過，也就是說程序重第15行開始執行。整個項目其實就一行代碼，其余都是模板文件，如果你想設置一個屬於你獨有的模板頭文件，請參考:pycharm設置文件模板

五.重點總結

總體說來python編程中的注釋一共兩個作用：

1.方便代碼閱讀

2.被注釋的代碼，程序不會執行

值得注意的是：如果程序的注釋不是在代碼的開始，那么該行代碼一樣會被執行，如下：

案例一：

1 print("helloworld") # python 編程創建的第一個項目

案例二:

1 # python 編程創建的第一個項目
2 print("helloworld")

兩個案例效果一樣，都會輸出helloworld ,寫法等效。