跳到主要内容

阶段学习任务单:开发者工具基础

这个阶段的目标不是记住所有命令,而是让你具备后续学习 AI 项目所需的基本开发工作流。学完后,你应该能创建项目、管理文件、安装依赖、使用 Git 保存版本,并把运行结果记录下来。

本阶段必须完成的任务

任务产出物通过标准
配置终端与常用命令一份命令练习记录能用命令创建、移动、查看和删除文件
配置 Python 开发环境一个可运行的 Python 项目目录能运行 python --version、安装依赖并执行脚本
配置 VS Code 或等价编辑器项目截图或配置说明能打开项目、运行文件、查看终端输出
掌握 Git 基础流程至少 3 次 commit 记录能解释 add、commit、status、log 的作用
连接远程仓库一个远程仓库地址或截图能 push,并能从远程确认文件存在

推荐学习顺序

先学习终端和文件操作,再配置 Python 环境,然后学习编辑器,最后学习 Git。不要一开始就纠结复杂分支模型,先把“本地改文件、提交、推送”这条主线跑通。

如果遇到环境问题,优先记录错误原文、操作系统、Python 版本、执行目录和完整命令。后续学习 RAG、Agent、部署时,大量问题本质上仍然是环境、路径和依赖问题。

和 AI 学习助手项目的关系

本阶段对应 AI 学习助手的 v0.1 项目骨架。你需要创建一个项目目录,准备 README,建立 Git 仓库,并写一个最简单的命令行入口。这个版本不需要 AI 能力,只需要让项目具备可持续迭代的工程基础。

推荐目录结构:

ai-learning-assistant/
README.md
src/
main.py
notes/
learning-log.md
requirements.txt

main.py 可以先只输出一行欢迎语。重点不是功能,而是你能否用固定命令运行它,并把结果写进 README。

常见卡点

最常见的问题包括命令执行目录不对、Python 版本混乱、依赖安装到错误环境、Git 没有配置用户名、远程仓库权限失败。解决这类问题时,不要只复制最后一行错误,要保留完整命令和完整输出。

阶段通关问题

学完后,你应该能回答这些问题:当前终端在哪个目录,Python 脚本是用哪个解释器运行的,项目依赖记录在哪里,Git 当前有哪些未提交修改,为什么每次完成一个小功能都应该提交一次。

完成状态 Checklist

  • 我能在终端进入项目目录,并说明当前命令在哪里执行。
  • 我能创建、运行和修改一个 Python 文件。
  • 我能用 Git 查看状态、提交变更,并理解 commit 记录的意义。
  • 我已经为 AI 学习助手建立项目骨架、README 和运行截图。
  • 我记录了至少一个环境或路径问题,以及自己的排查过程。