【程式學習】學程式前,一定要先學註解 ( HTML / PHP / CSS / MySQL / Python)

學程式前,先學註解


不論寫不寫註解,一定會用到註解在除錯時。

當然一個好的程式,寫註解絕對是十分動要的。

我覺得他寫的很好,可以參考文章-註解不是換句話說,是補程式的不足

摘錄出結論,大家參考(可點文章連結詳閱)

沒有人永遠能夠完全回到自己撰寫某一段程式碼時的心境,所以也沒有人能夠完全回憶起過去究竟為什麼要這麼寫程式碼。基於隨時能快速回復記憶,也基於團隊合作時的程式碼共享,撰寫註解絕對十分重要,而且有實際功用的工作。重點不在於寫下多少,而是在於註解與程式碼是否能相搭配。好的註解就和好程式碼一樣,不僅形式一致而且清晰。總之,好的註解從閱讀者的立場切入,並且切合閱讀者的心。


回正題,總之,不論你寫不寫註解,一定會用到它。
因為當程式很長時,除錯時註解掉一些,才執行除錯時,比較不會錯看。
太多行不好除錯。

但程式太多種,大致上註解的符號都大同小異。
這裡記錄著一些常用的註解,筆記一下。



一、HTML:

標準的 HTML 註解寫法
<!-- ... 這裡是註解文字 ... -->

HTML 多行註解使用簡單範例
<!--
這裡是多行 HTML 註解文字
這裡是多行 HTML 註解文字
一、HTML 標準的 HTML 註解寫法 -->

二、PHP:


PHP 單行註解範例//
<?php
// 這裡是單行 PHP 註解 ...
// 這裡是單行 PHP 註解 ...
?>


PHP 多行註解範例/*
<?php
/*
...這裡是多行 PHP 註解
...這裡是多行 PHP 註解
...這裡是多行 PHP 註解
*/

?>
三、CSS:

單行 CSS 註解的寫法範例//
<style type="text/css">
 // 這是單行註解
 // 這是單行註解

</style>
單行註解使用的是兩個斜線 //,在 // 之後的文字都視為註解,不可以換行,通常用來對單一 CSS 屬性(property)進行標註,單行註解如果一次用在很多行,效果也類似多行註解,只是要寫很多次而已,若一次有很多 Code 要註解,可以採用 CSS 內建的多行註解功能。

多行 CSS 註解的寫法範例
<style type="text/css">
 /*
 這是多行註解
 這是多行註解
 */

 ...
</style>
四、MySQL :

在SQL語法中使用 單行與多行註解範例//
常用的  #單行註解  /* 多行註解 */



五、Python:

Python 單行註解範例#
#Python單行註解


Python多行註解範例'''
'''
這是一個學習Python的練習程式
'''