100个老奶奶看了都懂的C语言教程 — 往代码里加注释——写给看代码的人看的备注计算机不会管它位置地图第一章 · 让计算机听你的话└── 第1课让计算机开口说话└── 第2课让计算机认识你的名字└── 第3课在屏幕上打印带数字的句子└──第4课往代码里加注释【这堂课讲什么】前几课你写的代码别人包括几天后的你自己看起来可能有点懵——“这行是干嘛的”“那个数字是什么意思”这节课你学一个本事在代码里写备注解释你写的每一行是干什么用的。计算机不会管这些备注它只关心代码。备注是写给人看的。分两步走认识两种写备注的方式//和/* */给前面几课的代码加上备注让它们变成能自己解释自己的代码做完之后你会知道怎么写备注、备注写在哪、备注里能写什么不能写什么。【老师先教】第一步打开你的代码文件夹Windows 用户按WinR敲cmd回车。然后在黑色窗口里敲cd C:\C100按回车。Mac 用户打开终端在黑色窗口里敲cd ~/C100按回车。Linux 用户打开终端在黑色窗口里敲cd ~/C100按回车。你怎么知道自己做对了光标前面出现了C100或~/C100的字样。第二步新建一个文件写带备注的代码Windows 用户type nul note.c echo #include ^stdio.h^ note.c echo int main() note.c echo { note.c echo // 这行在屏幕上打印一句话 note.c echo printf(Hello World\n); note.c echo return 0; note.c echo } note.cMac 用户touch note.c cat note.c EOF #include stdio.h int main() { // 这行在屏幕上打印一句话 printf(Hello World\n); return 0; } EOFLinux 用户touch note.c cat note.c EOF #include stdio.h int main() { // 这行在屏幕上打印一句话 printf(Hello World\n); return 0; } EOF你怎么知道自己做对了没有报错。文件已经建好了。第三步查看代码看看备注长什么样Windows 用户type note.cMac 用户cat note.cLinux 用户cat note.c你怎么知道自己做对了屏幕上显示#include stdio.h int main() { // 这行在屏幕上打印一句话 printf(Hello World\n); return 0; }看到//开头的那一行了吗那就是备注。它写着这行在屏幕上打印一句话下面正好就是干这件事的代码。第四步翻译并运行Windows 用户gcc note.c -o note.exe note.exeMac 用户gcc note.c -o note ./noteLinux 用户gcc note.c -o note ./note你怎么知道自己做对了屏幕上出现Hello World备注没有出现在屏幕上。备注是写给看代码的人看的计算机直接忽略它们。第五步认识第二种备注方式/* */除了//还有一种备注方式用/*开头*/结尾中间可以写好多行。再写一个文件看看。Windows 用户type nul multiline.c echo #include ^stdio.h^ multiline.c echo int main() multiline.c echo { multiline.c echo /* multiline.c echo 这个程序的作用 multiline.c echo 在屏幕上打印 Hello World multiline.c echo 然后告诉计算机结束 multiline.c echo */ multiline.c echo printf(Hello World\n); multiline.c echo return 0; multiline.c echo } multiline.cMac 用户cat multiline.c EOF #include stdio.h int main() { /* 这个程序的作用 在屏幕上打印 Hello World 然后告诉计算机结束 */ printf(Hello World\n); return 0; } EOFLinux 用户cat multiline.c EOF #include stdio.h int main() { /* 这个程序的作用 在屏幕上打印 Hello World 然后告诉计算机结束 */ printf(Hello World\n); return 0; } EOF你怎么知道自己做对了没有报错。文件建好了。第六步查看多行备注的代码Windows 用户type multiline.cMac 用户cat multiline.cLinux 用户cat multiline.c你怎么知道自己做对了屏幕上显示#include stdio.h int main() { /* 这个程序的作用 在屏幕上打印 Hello World 然后告诉计算机结束 */ printf(Hello World\n); return 0; }/*和*/之间的内容写了三行备注。这三行都不会被计算机执行。第七步给之前写过的代码加备注实操练习把你第二课的代码拿出来加上备注。Windows 用户echo #include ^stdio.h^ name_comment.c echo int main() name_comment.c echo { name_comment.c echo char name[20]; // 挖一个能存20个字符的格子 name_comment.c echo name[0]X; // 存第一个字母 name_comment.c echo name[1]i; // 存第二个字母 name_comment.c echo name[2]a; // 存第三个字母 name_comment.c echo name[3]o; // 存第四个字母 name_comment.c echo name[4]0; // 告诉计算机名字到这里结束 name_comment.c echo printf(My name is ^%s\n, name); // 打印名字 name_comment.c echo return 0; name_comment.c echo } name_comment.cMac 用户cat name_comment.c EOF #include stdio.h int main() { char name[20]; // 挖一个能存20个字符的格子 name[0]X; // 存第一个字母 name[1]i; // 存第二个字母 name[2]a; // 存第三个字母 name[3]o; // 存第四个字母 name[4]0; // 告诉计算机名字到这里结束 printf(My name is %s\n, name); // 打印名字 return 0; } EOFLinux 用户同上。你怎么知道自己做对了没有报错。文件建好了。可以敲type name_comment.cWindows或cat name_comment.cMac/Linux看看效果。第八步翻译并运行加好备注的代码Windows 用户gcc name_comment.c -o name_comment.exe name_comment.exeMac 用户gcc name_comment.c -o name_comment ./name_commentLinux 用户gcc name_comment.c -o name_comment ./name_comment你怎么知道自己做对了屏幕上出现My name is Xiaoming和没加备注之前一模一样。说明备注完全不影响程序的运行。两种备注方式对比备注方式写法适用场景单行备注// 备注内容在代码行后面或上面写一句简短说明多行备注/* 备注内容 */写一大段说明跨好几行总结规律//只管一行——从//开始到这行结束都是备注/*和*/管的是中间所有行——不管跨几行只要是/*和*/之间的内容都是备注【学生提问】学生问我写了//但后面的代码也被备注掉了运行出错了老师答//会让它后面整行都变成备注。如果你在一行代码的前面写了//那这行代码就不会被执行了。// printf(Hello World\n); ← 这行代码被备注掉了不会执行正确做法备注写在代码的上面一行或者写在代码行的后面。不要写在一行代码的前面除非你确实想关掉这行代码。学生问/* */备注里面还能再写/* */吗老师答不能。/* */备注不能嵌套。如果你写了/* 外面 /* 里面 */ 外面 */计算机会把第一个/*和第一个*/之间的内容当成备注后面的外面 */就不是备注了会报错。所以不要在/* */里面再套/* */。学生问备注要写多详细比较好老师答备注是写给看代码的人看的。通常这么写就够了这段代码是干嘛的一两句话某个数字为什么是这个值比如int age 18; // 法定成年年龄某段复杂的逻辑是怎么想的方便以后自己回来改不要写废话比如i i 1; // i加1——这行代码本身已经说明白了。【课后作业】作业1给第一课的 Hello World 加备注新建一个文件hello_comment.c把第一课的代码写进去然后给每一行加上//备注解释每一行的作用。翻译运行看看结果有没有变化。作业2用多行备注写一段程序介绍新建一个文件intro.c写一个能打印你的姓名和年龄的程序但开头用/* */写一段多行的备注介绍你自己比如这个程序是xxx写的“写于哪一天”“它的作用是什么”。翻译运行。作业3试试把备注写在代码前面新建一个文件test_comment.c写一行printf(Hello\n);然后在它前面加一行//备注再在它后面也加一行//备注。然后让其中一行的//跑到代码前面去也就是// printf(Hello\n);看看运行结果有什么变化。其他问题评论区留言看见后必回。标签#C语言 #入门教程 #零基础 #注释 #备注 #代码规范 #// #手把手作者华夏之光永存
老奶奶C语言入门教程系列——第4课_往代码里加注释
100个老奶奶看了都懂的C语言教程 — 往代码里加注释——写给看代码的人看的备注计算机不会管它位置地图第一章 · 让计算机听你的话└── 第1课让计算机开口说话└── 第2课让计算机认识你的名字└── 第3课在屏幕上打印带数字的句子└──第4课往代码里加注释【这堂课讲什么】前几课你写的代码别人包括几天后的你自己看起来可能有点懵——“这行是干嘛的”“那个数字是什么意思”这节课你学一个本事在代码里写备注解释你写的每一行是干什么用的。计算机不会管这些备注它只关心代码。备注是写给人看的。分两步走认识两种写备注的方式//和/* */给前面几课的代码加上备注让它们变成能自己解释自己的代码做完之后你会知道怎么写备注、备注写在哪、备注里能写什么不能写什么。【老师先教】第一步打开你的代码文件夹Windows 用户按WinR敲cmd回车。然后在黑色窗口里敲cd C:\C100按回车。Mac 用户打开终端在黑色窗口里敲cd ~/C100按回车。Linux 用户打开终端在黑色窗口里敲cd ~/C100按回车。你怎么知道自己做对了光标前面出现了C100或~/C100的字样。第二步新建一个文件写带备注的代码Windows 用户type nul note.c echo #include ^stdio.h^ note.c echo int main() note.c echo { note.c echo // 这行在屏幕上打印一句话 note.c echo printf(Hello World\n); note.c echo return 0; note.c echo } note.cMac 用户touch note.c cat note.c EOF #include stdio.h int main() { // 这行在屏幕上打印一句话 printf(Hello World\n); return 0; } EOFLinux 用户touch note.c cat note.c EOF #include stdio.h int main() { // 这行在屏幕上打印一句话 printf(Hello World\n); return 0; } EOF你怎么知道自己做对了没有报错。文件已经建好了。第三步查看代码看看备注长什么样Windows 用户type note.cMac 用户cat note.cLinux 用户cat note.c你怎么知道自己做对了屏幕上显示#include stdio.h int main() { // 这行在屏幕上打印一句话 printf(Hello World\n); return 0; }看到//开头的那一行了吗那就是备注。它写着这行在屏幕上打印一句话下面正好就是干这件事的代码。第四步翻译并运行Windows 用户gcc note.c -o note.exe note.exeMac 用户gcc note.c -o note ./noteLinux 用户gcc note.c -o note ./note你怎么知道自己做对了屏幕上出现Hello World备注没有出现在屏幕上。备注是写给看代码的人看的计算机直接忽略它们。第五步认识第二种备注方式/* */除了//还有一种备注方式用/*开头*/结尾中间可以写好多行。再写一个文件看看。Windows 用户type nul multiline.c echo #include ^stdio.h^ multiline.c echo int main() multiline.c echo { multiline.c echo /* multiline.c echo 这个程序的作用 multiline.c echo 在屏幕上打印 Hello World multiline.c echo 然后告诉计算机结束 multiline.c echo */ multiline.c echo printf(Hello World\n); multiline.c echo return 0; multiline.c echo } multiline.cMac 用户cat multiline.c EOF #include stdio.h int main() { /* 这个程序的作用 在屏幕上打印 Hello World 然后告诉计算机结束 */ printf(Hello World\n); return 0; } EOFLinux 用户cat multiline.c EOF #include stdio.h int main() { /* 这个程序的作用 在屏幕上打印 Hello World 然后告诉计算机结束 */ printf(Hello World\n); return 0; } EOF你怎么知道自己做对了没有报错。文件建好了。第六步查看多行备注的代码Windows 用户type multiline.cMac 用户cat multiline.cLinux 用户cat multiline.c你怎么知道自己做对了屏幕上显示#include stdio.h int main() { /* 这个程序的作用 在屏幕上打印 Hello World 然后告诉计算机结束 */ printf(Hello World\n); return 0; }/*和*/之间的内容写了三行备注。这三行都不会被计算机执行。第七步给之前写过的代码加备注实操练习把你第二课的代码拿出来加上备注。Windows 用户echo #include ^stdio.h^ name_comment.c echo int main() name_comment.c echo { name_comment.c echo char name[20]; // 挖一个能存20个字符的格子 name_comment.c echo name[0]X; // 存第一个字母 name_comment.c echo name[1]i; // 存第二个字母 name_comment.c echo name[2]a; // 存第三个字母 name_comment.c echo name[3]o; // 存第四个字母 name_comment.c echo name[4]0; // 告诉计算机名字到这里结束 name_comment.c echo printf(My name is ^%s\n, name); // 打印名字 name_comment.c echo return 0; name_comment.c echo } name_comment.cMac 用户cat name_comment.c EOF #include stdio.h int main() { char name[20]; // 挖一个能存20个字符的格子 name[0]X; // 存第一个字母 name[1]i; // 存第二个字母 name[2]a; // 存第三个字母 name[3]o; // 存第四个字母 name[4]0; // 告诉计算机名字到这里结束 printf(My name is %s\n, name); // 打印名字 return 0; } EOFLinux 用户同上。你怎么知道自己做对了没有报错。文件建好了。可以敲type name_comment.cWindows或cat name_comment.cMac/Linux看看效果。第八步翻译并运行加好备注的代码Windows 用户gcc name_comment.c -o name_comment.exe name_comment.exeMac 用户gcc name_comment.c -o name_comment ./name_commentLinux 用户gcc name_comment.c -o name_comment ./name_comment你怎么知道自己做对了屏幕上出现My name is Xiaoming和没加备注之前一模一样。说明备注完全不影响程序的运行。两种备注方式对比备注方式写法适用场景单行备注// 备注内容在代码行后面或上面写一句简短说明多行备注/* 备注内容 */写一大段说明跨好几行总结规律//只管一行——从//开始到这行结束都是备注/*和*/管的是中间所有行——不管跨几行只要是/*和*/之间的内容都是备注【学生提问】学生问我写了//但后面的代码也被备注掉了运行出错了老师答//会让它后面整行都变成备注。如果你在一行代码的前面写了//那这行代码就不会被执行了。// printf(Hello World\n); ← 这行代码被备注掉了不会执行正确做法备注写在代码的上面一行或者写在代码行的后面。不要写在一行代码的前面除非你确实想关掉这行代码。学生问/* */备注里面还能再写/* */吗老师答不能。/* */备注不能嵌套。如果你写了/* 外面 /* 里面 */ 外面 */计算机会把第一个/*和第一个*/之间的内容当成备注后面的外面 */就不是备注了会报错。所以不要在/* */里面再套/* */。学生问备注要写多详细比较好老师答备注是写给看代码的人看的。通常这么写就够了这段代码是干嘛的一两句话某个数字为什么是这个值比如int age 18; // 法定成年年龄某段复杂的逻辑是怎么想的方便以后自己回来改不要写废话比如i i 1; // i加1——这行代码本身已经说明白了。【课后作业】作业1给第一课的 Hello World 加备注新建一个文件hello_comment.c把第一课的代码写进去然后给每一行加上//备注解释每一行的作用。翻译运行看看结果有没有变化。作业2用多行备注写一段程序介绍新建一个文件intro.c写一个能打印你的姓名和年龄的程序但开头用/* */写一段多行的备注介绍你自己比如这个程序是xxx写的“写于哪一天”“它的作用是什么”。翻译运行。作业3试试把备注写在代码前面新建一个文件test_comment.c写一行printf(Hello\n);然后在它前面加一行//备注再在它后面也加一行//备注。然后让其中一行的//跑到代码前面去也就是// printf(Hello\n);看看运行结果有什么变化。其他问题评论区留言看见后必回。标签#C语言 #入门教程 #零基础 #注释 #备注 #代码规范 #// #手把手作者华夏之光永存
