小学信息科技课代码注释——基于2024年程序检查.docxVIP

小学信息科技课代码注释——基于2024年程序检查

摘要

摘要：代码注释是编程实践中提升程序可读性、可维护性与促进协作学习的重要环节，也是计算思维中抽象与模块化思想的体现。小学信息科技课程的编程教学正从图形化编程向文本编程过渡，培养学生良好的代码注释习惯至关重要。本研究旨在通过对大量学生程序文本的系统分析，探究小学生在编程任务中代码注释的使用现状、特征、质量及其与代码质量、学习理解的关系。研究于二零二四年三月至六月，在华东、华南、华北、中西、西南五区二十个城市（含四个直辖市）的一百所公立小学展开，收集信息科技课中学习文本编程（如图形化编程环境中的代码视图、或基础语言学习）的学生程序文件。总计分析有效程序文件一万二千份，重点检查其中注释行的存在、位置、内容、密度和质量。通过自然语言处理辅助与人工编码相结合的方法，对注释类型（如文件头注释、函数/模块注释、行内说明）、注释内容规范性、注释与代码逻辑的贴切度、以及注释存在的普遍问题进行量化与质性分析。研究发现：第一，代码注释意识整体薄弱，约百分之五十的程序文件中完全没有任何形式的注释，超过百分之七十的文件注释行数量不足总代码行的百分之五。第二，注释内容质量低下，在已有的注释中，约百分之六十为无意义的简单重复（如直接将代码翻译为自然语言）、或过于空泛的描述（如“这是一个函数”），未能揭示代码背后的设计意图或逻辑难点。第三，注释位置不当且分布不