Arduino 入门
从点亮第一颗 LED、读取按钮和传感器开始，学习数字/模拟输入输出、串口和基础程序结构。先跑通，再理解，最后试着改。
01 / 关于社团
一个把好奇心
变成作品的地方
我们不只是讨论技术，也会把东西真正做出来。可能是一个校园小工具，一段硬件程序， 或者一个只是觉得好玩的硬件小装置。
衡南一中编程社（HNYZ）是一个面向全校学生的技术类社团，教学围绕 Arduino 展开。 成员里有写代码的、做设计的、研究硬件的，也有刚让第一颗 LED 亮起来的新朋友。
我们不要求你先会写代码，也不要求你一开始就有完整的项目。 比起“准备好了再来”，我们更相信在做的过程中学会。 每周留一点时间，把手上的东西往前推一步，有问题就在群里问。
先做一个能跑起来的小东西，再慢慢把它做得更好。
- 社团名称
- 衡南一中编程社 · HNYZ
- 面向对象
- 衡南一中全体学生
- 活动频率
- 每周 2 次，每次 1 小时
- 加入方式
- QQ 群 1098931492
- 联系邮箱
- [email protected]
02 / 我们做什么
从第一行代码
到第一个作品
不管你现在会多少，都可以从适合自己的位置开始。技术不是唯一入口， 把一件事做好需要不同的角色。
硬件项目实战
组队做 Arduino 小装置、传感器互动和校园硬件小工具。有人写程序，也有人做电路、结构、测试和文档。
程序与调试
围绕 Arduino 项目练习变量、循环、函数和状态判断，学会看串口输出、定位问题，再把思路延伸到算法与竞赛。
分享与协作
每周两次、每次一小时的活动里安排主题分享，把踩过的坑写成文档。代码、设计、文案全部开放，互相 review，也互相兜底。
04 / ACTIVITY_RHYTHM
每周两次
每次一小时
社团常规活动一周两次，每次 60 分钟：一次偏分享和结对，一次偏自由开发和问题排查。 时间紧凑，但每次都能带走一个能跑的小进展。具体时间、地点以 QQ 群公告为准。
每周 · 第一次 · 60 MIN
主题分享 + 结对开发
用一小时从一个具体的小主题开始，讲完就动手。新手可以和学长学姐结对，把环境跑通、把第一个功能写出来。
每周 · 第二次 · 60 MIN
自由开发 + 问题排查
带来你正在做的项目，或者从零开始一个。遇到报错、卡住思路，就在这一小时里集中解决。
每月 · 60 MIN
小型 Demo Day
用一小时展示这个月做出来的东西，接受提问，也接受不完美。做完比完美更重要。
05 / RESOURCE_WALL
墙上的
学习入口
不知道从哪里开始的时候，先从资源墙上的链接点进去。 C++ 基础可以配合 Arduino 项目一起看，ESP32 部分统一看微雪的 Wiki。
[ 01 ]
[ 02 ]
CPP / TUTORIAL
C++ 菜鸟教程
从基础语法、数组、指针到面向对象，适合配合 Arduino 和算法练习一起看。
WAVESHARE / ESP32
微雪 ESP32 教程
微雪电子 ESP32-S3 开发板 Wiki：环境搭建、GPIO、Wi-Fi、蓝牙、屏幕和示例代码都在这里。
资源墙会持续补充。有想推荐给社团的教程、工具或项目，欢迎在 QQ 群里发链接。
06 / FAQ
加入之前
你可能想知道
零基础可以加入吗？
可以。社团里有很多人也是从零开始的。你不需要先学完某门课再来，带着问题和兴趣来就够了。
社团主要教什么？
教学内容以 Arduino 为主线：从点亮 LED、读按钮和传感器开始，学习数字/模拟输入输出、串口、简单控制逻辑，再完成一个完整的硬件小项目。ESP32 会作为进阶平台接触。
需要自己带电脑吗？
有电脑会更方便，但不是硬性要求。没有电脑也可以先来听分享、参与讨论和设计，之后再决定怎么参与项目。
不是技术方向也能加入吗？
可以。一个项目除了写代码，还需要设计、文案、测试和活动组织。你可以先认领一件小事，再慢慢找到自己擅长的部分。
活动时间是什么时候？
常规活动每周两次，每次一小时：一次主题分享 + 结对开发，一次自由开发 + 问题排查。具体时间和地点会在 QQ 群公告里通知，考试周会适当调整。
项目卡片的数据从哪里来？
由 js/main.js 读取 data/repos.json——一份每天凌晨由 GitHub Actions 抓好的仓库快照，不消耗你的 API 额度。快照里缺某个仓库、或者文件读不到时，才会回退到 GitHub API 实时请求；再不行还有本地缓存和降级卡片，页面不会空白。
07 / GUESTBOOK
留一句话
给下一个人看
留言用 GitHub 账号发表，存在仓库的 Discussions 里。不设匿名， 也没有第三方服务器——删库才会消失。
$ tail -f ~/hnyz/guestbook.log
滚动到这里才开始连接 GitHub，不拖首屏。
08 / JOIN_US
下一次活动
来坐坐
不限年级与班级，零基础也欢迎。先进群看看大家在做什么， 再决定要不要一起做点什么。
-
加 QQ 群
群号 1098931492，备注「班级 + 姓名」。
-
来一次活动
先听、先看，找到你感兴趣的项目或方向。
-
认领一件小事
从文档、设计、测试或一小段代码开始，先参与进来。