新手常见问题 FAQ

安装 Python 只需三步：

• 第一步：访问 Python 官网 python.org/downloads，下载对应你操作系统的安装包（推荐下载最新的稳定版）。
• 第二步：运行安装程序。Windows 用户务必勾选底部的 "Add Python to PATH" 选项，这一步非常关键，否则后续在命令行中无法直接使用 python 命令。
• 第三步：安装完成后，打开命令行（Windows 按 Win+R 输入 cmd），输入 python --version，如果显示版本号则说明安装成功。

零基础入门，以下工具按优先级排列：

• Python 运行环境（必须）：就是上面安装的 Python，用来运行代码。
• 代码编辑器（必须）：推荐 VS Code，免费轻量，对新手非常友好。
• 包管理工具 pip（自动附带）：安装 Python 后自带，用来安装第三方库，如 pip install pygame。
• Git 版本控制（推荐）：用来管理代码版本，初学可暂不深入，但建议早早安装。
• 现代浏览器（前端必须）：Chrome 或 Edge，用于前端开发和调试。

这是因为安装时没有勾选 "Add Python to PATH"，导致系统找不到 Python。解决方法：

• 方法一（推荐新手）：重新运行安装包，选择 "Modify"（修改），确保勾选 "Add Python to environment variables"，然后完成安装。
• 方法二：手动添加环境变量。在系统环境变量的 Path 中添加 Python 的安装路径（如 C:\Users\用户名\AppData\Local\Programs\Python\Python3xx\）。
• 修改后重新打开命令行窗口，再输入 python --version 验证。

三者各有侧重，简单对比：

• VS Code：微软出品的轻量级编辑器，免费、启动快、插件生态丰富。支持 Python、前端、几乎所有语言。强烈推荐初学者使用。
• PyCharm：JetBrains 出品的专业 Python IDE，功能强大（智能补全、调试、重构），但体积大、启动慢。社区版免费，专业版收费。适合有一定基础后深入 Python 开发。
• Jupyter Notebook：以"单元格"形式运行代码，适合数据分析、机器学习和交互式探索。不适合做完整项目，但做实验和演示很方便。

推荐安装以下核心插件：

• Python（微软官方）：Python 语法高亮、智能补全、调试，必装。
• Chinese (Simplified)：中文语言包，让界面变中文。
• Live Server：前端开发必备，实时预览网页效果。
• Code Runner：一键运行代码，方便测试。
• Prettier：代码格式化工具，保持代码整洁。

不需要一次装太多，用到什么场景装对应插件即可。

IDLE 是 Python 安装后自带的轻量编辑器，能写代码、能运行，最初期完全够用。但它的功能比较基础：没有代码补全、没有项目管理、没有 Git 集成。

当你开始写稍微复杂的项目（比如 Pygame 游戏），IDLE 就会力不从心。所以建议：

• 第 1-2 天：可以用 IDLE 感受一下 Python，敲几行代码找找感觉。
• 之后：切换到 VS Code，体验代码补全、文件管理等完整功能。

根据站内的 学习路线图，零基础到能独立做项目，大致时间线如下：

• 阶段一：编程入门（1-2 周）：掌握 Python 基础语法（变量、条件、循环、函数）。
• 阶段二：创意编程（2-3 周）：用 Turtle 库画图形，巩固语法、培养兴趣。
• 阶段三：游戏开发（3-4 周）：用 Pygame 做出可玩的小游戏。
• 阶段四：前端开发（4-6 周）：学习 HTML/CSS/JS，做出网页。

总计约 10-15 周可达基础水平，能独立完成简单项目。全栈进阶（React/Node.js）为持续学习，没有固定终点。

建议的日常学习安排：

• 每天 1-2 小时：最佳节奏，能保证专注力又不会太累。
• 每周 5-6 天：保持手感，留 1 天休息或复习。
• 时间分配：30% 看教程理解概念，70% 动手敲代码实践。

不需要每天学很久，坚持比强度更重要。每天 1 小时坚持 3 个月，远比突击 3 天每天 10 小时效果好。

这是每个编程新手都会经历的正常阶段，不用焦虑。应对策略：

• 学了就忘：正常现象。不需要死记硬背，记住"有这个功能"即可，用到时查文档。多做项目，用着用着就记住了。
• 跟不上进度：按自己的节奏来，不要和别人比。路线图的周期只是参考，慢一点完全没问题。
• 遇到瓶颈：换个方式，比如看视频教程、换个小项目练手，或者到 交流群 提问。
• 想放弃时：回顾一下你已经学会的东西，你会发现自己已经走了很远。

推荐从 Python 开始，原因如下：

• Python 语法简洁，最接近自然语言，零基础最容易上手。
• Python 生态丰富，学会后可以往游戏开发（Pygame）、数据分析、自动化、AI 等多个方向发展。
• 本站的教程以 Python 为核心，配套资源最齐全。

如果你想直接学前端（HTML/CSS/JS）也可以，但建议先花 1-2 周学 Python 基础，建立编程思维后再学其他方向会更轻松。

简单理解：

• 前端：用户能看到的部分。用 HTML（结构）、CSS（样式）、JavaScript（交互）做网页。视觉效果直观，成就感强。
• 后端：用户看不到的部分。处理数据、逻辑、数据库。用 Python、Node.js、Java 等语言写服务器程序。
• 全栈：前端 + 后端都会，能独立做一个完整的应用。

新手建议：先学前端（能看到效果，有成就感），再学后端（理解数据处理），最后走向全栈。也可以反过来，先用 Python 学后端逻辑，再补前端。

兴趣是最好的老师，但直接跳到 Pygame 可能会卡在基础语法上。建议的路径：

• 先花 3-5 天过一遍 Python 基础（变量、if、for、函数），不需要很深入。
• 然后直接上手 Pygame，在做游戏的过程中边学边练。
• 遇到不懂的语法，回头查 基础教程 即可。

本站有完整的 Pygame 游戏开发系列，从贪吃蛇到俄罗斯方块，跟着做就能学会。

本站提供了多种方式帮你找到合适的教程：

• 学习路线图：最推荐！按阶段排列，从零基础到进阶，跟着走就行。
• 专题系列：按主题分类（Python 基础、Pygame、Turtle、前端等），每个系列有难度标注。
• 博客页：所有文章列表，每篇都有难度标签（入门/进阶/实战）。
• 归档页：按时间线浏览所有教程。
• 站内搜索：直接搜索关键词找教程。

本站教程按难度分为三个级别：

• 入门：零基础可学，讲解详细，适合刚接触编程的同学。
• 进阶：需要一定基础（如学完 Python 基础语法），会涉及更复杂的概念和技巧。
• 实战：以完整项目为主线，综合运用多种知识，适合想动手做东西的同学。

建议按"入门 - 进阶 - 实战"的顺序学习每个主题。

在每篇文章页面，你可以：

• 点赞：觉得文章有帮助就点个赞，支持作者继续创作。
• 收藏：把喜欢的文章加入收藏夹，方便以后复习。

收藏和点赞记录保存在浏览器本地（localStorage），无需登录。你可以在导航栏"更多"菜单中找到 我的收藏 和 我的点赞 查看记录。

加入交流群非常简单：

• 访问 首页的交流社群板块，可以看到所有可加入的群组入口。
• 目前提供 微信群 和 QQ 群 两种渠道，扫描对应二维码即可加入。
• 群内可以提问、分享作品、交流学习心得，也有不定期的资源和活动分享。

本站所有教程完全免费，没有付费墙。所谓"进阶层"指的是：

• 路线图中阶段四和阶段五（前端开发、全栈进阶）属于进阶内容。
• 这些内容需要先掌握前面阶段的基础知识才能看懂，所以建议按顺序学习。
• 部分进阶资源（如完整项目源码）可能需要关注公众号或加入交流群获取，但不收费。

关注 公众号 可以获取更多进阶资源和更新通知。

好的提问方式能大大提高获得帮助的概率：

• 描述问题：说清楚你想做什么、遇到了什么问题、报错信息是什么。
• 附上代码：把相关代码贴出来（用代码块格式），不要只截图。
• 说明已尝试：告诉别人你已经试过哪些方法，避免重复建议。
• 保持耐心：大家都是利用空闲时间帮忙，可能不会立刻回复。

反例："代码跑不了，怎么办？" -- 信息太少，没人能帮。
正例："我在写 Pygame 贪吃蛇，碰撞检测不生效，蛇穿过了食物。代码如下：..." -- 清晰明了。

获取源码有以下途径：

• GitHub：访问 github.com/ppaqtt，所有开源项目代码都在这里。可以 Clone 或下载 ZIP。
• Gitee：国内访问更快，访问 gitee.com/pingping-aicha-sugar。
• 资源下载页：访问 资源下载页，部分项目打包好了直接下载。
• 文章内嵌：大部分教程文章中会直接贴出完整代码，可以复制使用。

资源下载页提供以下几类资源：

• 项目源码：教程中涉及的完整项目代码（Pygame 游戏、Turtle 绘图、前端项目等）。
• 学习资料：Python 速查表、命令大全、知识点思维导图等。
• 工具推荐：开发工具安装包链接、配置教程等（也可查看 工具页）。
• 素材资源：游戏开发用的图片、音效素材，前端开发的图标和模板等。

所有资源免费下载，部分可能需要关注公众号获取提取码。

如果遇到下载问题：

• GitHub 访问慢：国内用户建议用 Gitee 镜像，或使用加速工具。
• 网盘链接失效：可能是链接过期了，到 交流群 反馈，会及时更新。
• 提取码不对：关注公众号后获取最新提取码。
• 其他问题：发邮件到 ppkjgzs@qq.com 描述问题。

学习路线图 是本站的核心导航工具，使用方法很简单：

• 按顺序学习：路线图分为 5 个阶段，从阶段一到阶段五依次推进。
• 每个阶段有知识点：列出了该阶段需要掌握的核心概念。
• 点击推荐教程：每个阶段都关联了站内的精选教程，直接点击学习。
• 跳过已掌握的：如果某个阶段你已经会了，可以直接跳到下一阶段。
• 投票反馈：页面底部可以投票告诉作者你最期待哪个系列，影响后续更新优先级。

关于学习进度的保存：

• 保存方式：进度通过浏览器的 localStorage 保存在本地，点击"标记完成"按钮即可记录。
• 无需登录：不需要注册账号，打开路线图页面就能看到上次的进度。
• 换设备/换浏览器：进度不会同步，因为数据只存在当前浏览器中。新设备上需要重新标记。
• 清除浏览器数据：进度会丢失，建议截图备份重要进度。
• 重置进度：点击进度条旁的"重置"按钮可以清除所有打卡记录，重新开始。

路线图会持续更新：

• 现有阶段：会不断补充新的知识点和推荐教程。
• 规划中的系列：数据可视化系列、Web 全栈实战等正在筹备中，具体时间看 更新排期。
• 你的投票很重要：路线图底部的投票功能会直接影响更新优先级，得票高的系列会优先制作。
• 关注更新：可以通过 RSS 订阅 或关注公众号第一时间获取更新通知。