马哥的python小屋是一个免费的Python入门学习网站。这篇文章写给完全没接触过编程的朋友。网站怎么用、先学什么、遇到问题怎么办，这篇一次讲清楚。
大家好，我是 @马哥python说 ，一名10年+程序员。
最近一段时间，主要精力都在开发维护自己原创的一些采集工具、软件。很久没有在python基础上分享过干货了，都差点忘了自己一开始的初衷 - -。这不，这几天执行力又上来了。趁着这股劲头，从第一行代码到最终发布上线，一把梭了。
其实，我身为一名python技术博主，运营一个完全属于自己的学习社区，方便各路朋友一起学习python、共同提升技术，这个想法由来已久了。随着AI能力的普及，它也终于在无数次的反复优化调整中顺利上线了，现在就把这个工具推给大家：马哥的python小屋
一、这个网站是什么？适合谁？
简单说：一个像书一样一页页讲 Python 的网站。
- 目前有7个章节、25篇教程，从「Hello World」讲到「类和对象」，Python入门最核心的知识基本都覆盖了；
- 每篇教程都有能直接运行的代码例子，解释尽量说人话，没有看了就犯困的长篇大论；
- 完全免费，不用充会员。
适合以下几类人群：
- 完全零基础、想学编程但不知道从哪下手的新手；
- 学过一点但知识零散，想系统过一遍的人；
- 学生党、转行党、想给简历加技能的打工人。
二、3分钟学会用这个网站
第 1 步：打开首页
浏览器输入mgcoding.com，手机电脑都行。
首页上半部分是一段欢迎语，下半部分是全部课程目录，按「第一章、第二章……」排好。一页就能看到所有25节课。
第 2 步：跟着顺序学
点进第一节课「Hello World」，你会看到：
- 左侧目录：告诉你现在在第几章、前后是什么内容，不会迷路；
- 正文：讲解加代码示例。代码块右上角有个复制按钮，一键复制，不用手敲；
- 文章自带目录：长文章可以点小标题直接跳转；
- 页面底部有「上一课 / 下一课」按钮，学完直接点「下一课」继续，不用回首页。
顺便交代一句背景：这些教程不是存在数据库里的，每篇就是一个普通的Markdown文件，我把写好的文件放进对应文件夹，网页就自动更新了。这也是这个网站内容更新起来这么直接的原因。
建议按章节顺序学。前几章（变量、字符串、流程控制）是地基，跳着学容易卡壳。
第 3 步：动手敲代码
光看不练假把式。教程里的每段代码，建议都复制下来，在自己电脑上跑一遍（Python怎么装，在「Hello World」那一节有详细说明）。
跑出和教程一样的结果，再试着改一两个数字、换几个字。报错是正常的，改了再跑，就学会了。
三、找不到想看的内容？用搜索
首页顶栏（手机端在菜单里）有一个搜索框。
想找「列表」就输入「列表」，想找「循环」就输入「循环」，搜出来的结果会显示是哪一节的、匹配在哪一段。不用记住教程名，用中文搜就行。
四、注册一个账号，开始参与交流
为什么要注册？
注册后你才能发表评论、回复同学、改自己的头像和昵称。
怎么注册？
- 点右上角「
登录」，再点登录框下方的「注册」； - 填用户名、邮箱、密码（密码至少 6 位，输两遍确认）；
- 答一道简单的算术验证码（比如 3 + 5 = ?）；
- 点提交，自动登录成功。
放心，网站只保存你填的这些信息。密码不是明文存的，而是哈希之后存下来，网站自己都看不到。
忘记密码了怎么办？
登录页点「忘记密码」→ 输入注册邮箱 → 去邮箱收一封重置邮件 → 点邮件里的链接设置新密码。链接30分钟内有效，过期就重新申请一次。
五、评论区和同学交流
每篇教程最下面都有评论区。有不懂的地方，或者有心得，都可以留言：
- 点「
发表评论」写下内容，点提交； - 别人的评论下面可以点「
回复」，会提示你在回复谁； - 每 10 秒只能发一条评论，防止刷屏。这是防广告的，不是限制你说话。
提问的小建议：把问题说具体一点（「我运行第 3 节的计算器代码报了这个错：xxx」），比「为什么我的不行」更容易得到有效回答。
六、一个贴心的小功能
学习是个长期的事儿，为了保护咱们的视力，我在网站里加入了明暗模式：
**自动显示：**18:00～次日6:00，页面自动显示暗黑模式；6:00～18:00，页面自动显示明亮模式。（判断用的是访问者本地时间，不是服务器时间，所以无论你身在这个星球的哪儿，都会准确生效）
**手动调整：**右上角有个「太阳/月亮」图标，点一下切到暗黑模式，晚上学习不刺眼，设置也会被记住。
七、顺便聊聊：这网站是怎么做出来的
网站本身不大，技术也一点都不玄乎，懂点编程的人看一眼就明白：
- 后端是Python的
Flask框架，全部路由都写在 app.py 一个文件里，大概590行； - 教程内容不进数据库，每篇就是一个
Markdown文件，带一点YAML 头部信息（标题、简介、日期）。作者改完文件，页面刷新就更新，没有后台管理系统； - 评论和用户数据存
SQLite，就是一个本地文件，备份等于把它拷走； - 页面是服务端渲染的：
Markdown在服务器上转成HTML再发给浏览器，代码高亮也是服务端生成的，所以打开就有样式，不用等脚本； - 部署在
Windows服务器上，用 Waitress 跑 WSGI，外面套 Cloudflare 提供 HTTPS 和 CDN。
对学Python的人来说，这个小站本身就是一个现成的学习样本：Flask、SQLite、Markdown处理，都是入门阶段能看懂的技术。
八、常见问题 / FAQ
Q：学完 25 节课能到什么水平？
A：能看懂大多数入门代码、自己写小工具（处理 Excel、抓网页、写小游戏）的程度。学完如果觉得不够，可以继续找实战项目练手。
Q：手机上能学吗？
A：能，手机浏览器直接打开就行，页面会自动适配。不过建议代码部分在电脑上练习，跟着敲才有感觉。
Q：评论一直发不出去？
A：先确认自己登录了；再检查是不是 10 秒内发了第二条。都不是的话，可能是网络问题，刷新重试。
Q：注册时提示用户名/邮箱已被使用？
A：说明别人已经注册过了，换一个用户名（邮箱如果确实是你的，可以试试「忘记密码」）。
Q：会收费吗？会有广告吗？
A：目前完全免费，也没有弹窗广告。网站靠作者用爱发电，觉得有用的话，去公众号请马哥喝杯咖啡。
Q：网站内容会更新吗？
A：会的，教程还在持续增加，建议时不时回来看一眼首页有没有新章节。
END、最后给新手的三句话
- 先跑通，再理解：把示例代码跑起来，比看十遍讲解都有用；
- 报错不是失败：编程就是「报错 → 改 → 再跑」的循环，报错信息里往往写着答案；
- 每天
30分钟：不用突击，细水长流，一个月后回头看，你会发现自己已经走得很远了。
最后，欢迎来到 马哥的python小屋 ，祝你学得开心！
