编程语言的注释

为什么要引入注释?

• 经常会忘记自己的代码的意图和思路, 导致需要浪费额外的时间去重新理解自己写的代码
• 协作时,或者后期升版时,很难理解他人的意图

意识

• 注释是为了方便你自己和同事, 而不是用来帮助计算机. 也就是说注释是给你和同事看的，不是给程序执行的, 注释的内容不会被程序解读
• 注释的派生应用: 在调试代码时, 我们可以把把某一部分代码注释掉, 来临时跳过这部分的代码, 从而进行对比调试

编程语言的 2 大注释风格

1. Unix Shell 注释风格
   • 单行 # (Shell 没有标记多行注释的字符, 只能是一行一行老老实实写 #)
2. C 注释风格
   • 单行 // (准确的说, 这是C++的注释风格)
   • 多行 /* */

各编程语言的注释方法

需求	HTML	CSS	Python	JavaScript	PHP	SQL
单行注释和行末注释	<!--注释内容-->	/*注释内容*/	# 注释内容	// 注释内容	//	--注释内容
多行注释	<!--注释内容-->	/*注释内容*/	# 注释内容或者'''注释内容'''	/* 注释内容 */	/* 注释内容 */	/* 注释内容 */

记忆要点:

• HTML和CSS和Python的单行和多行注释是相同的
  • HTML是<!--注释内容-->
  • CSS是/*注释内容*/
  • Python是# 注释内容, 同时Python使用"三重引号字符"'''注释内容'''
• JavaScript和SQL的单行和多行注释是不同的
• JavaScript和PHP的单行和多行注释是一样的
• CSS, JavaScript和SQL的多行注释是相同的, 都是/* 注释内容 */, 注意, Python没有这种注释
• Python的“三重引号字符“原来的作用是界定跨行的字符串. 因为没有"变量名"，程序不会对字符串处理，所以可以被用于注释; 但不推荐作为“注释”使用, 因为不显眼; 同时, 因为比#注释方便, 推荐临时使用于让部分代码暂时不被执行;