波仔
🧡 第二章 10分钟快速起步：安装与配置
📄 一句话概括

安装动作本身没什么可看的，可看的是装完之后的三个验证点：命令找得到、版本读得出、目录进得对。

📝 本节和前面几节的关系

上一节挑好了路子，这一节照着走一遍，并立好验收标准。

一、装之前先做两件小事

第一，记下你现在所在的目录。工具喜欢在项目目录里干活，你得知道它装到哪、活在哪。 第二，把当前的目录清干净。在一个空目录或一个干净项目里试跑，比在半路一个乱糟糟的文件夹里试跑好得多。 这两步花不了一分钟，却能省掉后面大半的排查时间。

二、装的过程：跟着官方文档走

官方文档的安装步骤通常就三到四条命令，照抄执行，不要凭记忆改。 容易出岔子的地方是网络：下载那一步在国内可能很慢或超时。这一步决定了你该不该换路子。 如果卡在下载上，先别急着改命令，换个源或换个方式再来。

三、装完的三个验证点

命令找得到：在终端里敲它，提示不是【不是内部或外部命令】。 版本读得出：敲版本命令，能打出一串版本号。 目录进得对：在真实项目目录里开它，让它先列一下当前目录的文件——它报出来的内容应该和你看到的一致。 三条都过，才算装成。任何一条不过，回到对应环节查，别将就。

四、动手 Demo：安装过程要盯的三个验证点

下面这段在沙箱里做一次同构演示：逐条检查、过就打勾、过不了报原因。

checks = [("命令能被找到", lambda: bool(sys.executable)),
          ("版本号读得出来", lambda: sys.version_info[0] >= 3),
          ("工作目录存在", lambda: os.path.isdir(os.getcwd())),
          ("临时目录可写", lambda: _writable())]
for name, fn in checks:
    P("  [%s] %s" % ("过" if fn() else "不过", name))

实跑输出：

--------------------------------------------------------------------
安装过程要盯的三个验证点
--------------------------------------------------------------------

安装本身没什么可看的，可看的是**装完之后你怎么确认它真的活了**。
下面这段在沙箱里做一次同构演示：逐条检查、能过就打勾、过不了就报原因。

  [过] 命令能被找到         python.exe 可执行
  [过] 版本号读得出来        Python 3.13.14
  [过] 工作目录存在         ch25_dev
  [过] 临时目录可写         写入测试文件

真实安装时，把这四条换成：能敲到命令、能出版本号、能进项目目录、能读写文件。
四条全过再往下走；有一条不过，先解决它，别急着开工。

沙箱里四条全过，是因为沙箱本身就是个能跑能写的干净环境——真实机器上第 2 条（版本读得出）和第 4 条（可写）最常出问题。 把这四条换成真实世界的版本：能敲到命令、能出版本号、能进项目目录、能读写文件。

30 秒实验

  1. 装完之后，别急着跑活——先把上面四条各验一遍，记下哪条没过。
  2. 在真实项目目录里开它，让它报一遍当前目录的文件，和你眼睛看到的对一对。

常见误区

  1. 装完直接开工。装没装成这件事必须主动验证，被动等它报错等于把时间浪费在排查上。
  2. 在半路一个乱七八糟的目录里试跑。先把地扫干净，不然出问题分不清是它坏了还是目录乱。
自测三问（点开对答案） 1. 装完必须主动验证哪几条？ —— 命令找得到、版本读得出、目录进得对，外加它能读写文件。 2. 安装过程中最容易出岔子的是哪一步？ —— 下载那一步——网络慢或超时，容易让人改错命令。 3. 为什么要在干净目录里试跑？ —— 出了问题能分清是工具坏了还是目录本来就乱。

相关笔记