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

新手最常栽的五个坑：装完不重启终端、路径没进环境变量、多版本共存、网络拉不动、目录选错——后三个的根子都是【你以为装好了，其实装到了别的地方】。

📝 本节和前面几节的关系

上一节走完了流程，这一节把流程上最容易翻车的五个点摊开讲。

一、坑一：装完不重启终端

安装过程会修改环境变量，而已经开着的那个终端窗口还拿着旧的一份。 于是命令明明装好了，敲却说找不到。最快的解法：关掉那个窗口，重新开一个。 新手常常在这里反复重装——重装十遍不如重开一次窗口。

二、坑二：路径没进环境变量

装到了某个目录，但系统不知道那个目录里住着可执行文件。 解法是照官方文档把那个目录加进 PATH，然后重开终端。 判断依据很直接：敲命令报找不到＝装上了但没进 PATH，而不是没装。

三、坑三：多版本共存

电脑里可能同时有好几套同类运行时，你装的那份和实际跑的那份不是同一套。 症状是：安装过程一切正常，跑起来却行为古怪。解法是先查版本号，确认自己用的是哪一套。 这一坑最隐蔽，因为表面全绿。

四、坑四与坑五：网络与目录

网络：下载卡在半路或超时，不是配置错，是链路慢。换源、换方式，或者换一条安装路子。 目录：装到临时目录、或者一个会被清理的文件夹里，过段时间工具就不见了。装到固定位置。

五、这五个坑的共同根子

其中三个的根子是同一句话：你以为装好了，其实装到了别的地方。 对付它的办法不是重装，而是验证：第 2.7 节的自检清单就是为它准备的。

六、动手 Demo：新手最容易踩的五个坑

下面把五个坑按【表面现象—怎么办】列出来，下次撞上直接查表。

pits = [("装完不重启终端", "命令敲了说找不到", "关掉重开终端窗口"),
        ("路径没进环境变量", "命令敲了报找不到", "把安装目录加进 PATH"),
        ("多版本共存", "装到了另一套运行时上", "先查版本，确认用哪一套"),
        ("国内网络拉不动", "下载卡在半路或超时", "换镜像源，或换安装方式"),
        ("目录选错", "装在了会被清理的地方", "装到固定位置，别装临时目录")]

实跑输出：

--------------------------------------------------------------------
新手最容易踩的五个坑
--------------------------------------------------------------------

  坑                   表面现象                        怎么办
  --------------------------------------------------------------------------------------
  装完不重启终端       终端还认着旧的环境变量          关掉重开一个终端窗口
  路径没进环境变量     命令敲了报找不到                照官方文档把安装目录加进 PATH
  多版本共存           装到了另一套 Python/Node 上     先查版本，确认用的是哪一套
  国内网络拉不动       下载卡在半路或超时              换镜像源，或走包管理器
  目录选错             装在了临时目录或被清理          装到固定位置，别装到会被删的地方

五个坑里有三个的根子是同一个：**你以为装好了，其实装到了别的地方。**
所以别急着判断成功标准——用下一节的自检清单确认。

注意前两行现象几乎一样，都是【命令找不到】，但根子不同：重启窗口治第一种，改 PATH 治第二种。 所以卡住时先分清是哪种，别把两个办法一起用——一起用会掩盖真正的问题。

30 秒实验

  1. 回忆一下：装好却找不到命令时，你是重装了，还是重开了终端窗口？
  2. 查一下你电脑上是否同时存在多套同类运行时（多个 Node、多个 Python 都可能）。

常见误区

  1. 找不到命令就重装。八成的情况重开终端就好了，重装只会掩盖真正的原因。
  2. 把五个解法一起用。一起用会让下一次排查失去参照，一次只改一处。
自测三问（点开对答案） 1. 装完命令找不到，最该先做什么？ —— 先重开一个终端窗口；不解决再查 PATH，而不是立刻重装。 2. 哪两个坑的现象几乎一样？ —— 装完不重启终端、路径没进环境变量，都是命令找不到。 3. 五个坑的共同根子是什么？ —— 你以为装好了，其实装到了别的地方——所以解法是验证而非重装。

相关笔记