Python编程:从入门到实践
章节

附录 A 安装及故障排除

把环境问题提前变成可排查清单

附录 A 是环境与故障排查补丁包,帮助初学者把起步阶段最常见的卡点提前消化。

章节主张

学习编程时,稳定的故障排查能力往往比一次性装好环境更有长期价值。

中文释读

很多初学者会把安装问题当成自己不适合学编程,其实这只是工程世界的日常。附录 A 的真正作用,就是把环境问题去神秘化:版本、路径、运行失败、扩展异常,都可以被拆成步骤检查。你一旦习惯这样看问题,后面的学习心态会稳很多。

本章知识路线

  1. 环境稳定比背更多语法更值钱
  2. 排错不是意外插曲,而是开发能力本身

关键论点

  • 环境问题是初学阶段最常见的非认知障碍。
  • 排错能力本身就是编程训练的一部分。
  • 提前建立检查清单能显著降低挫败感。

行动清单

  • 把常见安装故障整理成固定排查顺序。
  • 遇到问题先看版本、路径、终端输出。
  • 保留能复用的环境解决记录。

源章节深读

附录 A 安装及故障排除 Python 有很多版本,在各种操作系统中安装 Python 的⽅式也很多。如 果第 1 章介绍的⽅式不管⽤,或者要安装⾮系统已有的 Python 版本, 本附录可提供帮助。 A.1 Windows 系统 第 1 章介绍了如何使⽤ Python ⽹站提供的官⽅安装程序来安装 Python 。如 果执⾏安装程序后,⽆法运⾏ Python ,本节的故障排除说明将帮助你让 Python 恢复正常。 A.1.1 ⽤ py 代替 python 运⾏较新的 Python 安装程序后,如果在终端中执⾏命令 python,应该会 看到表⽰终端会话的提⽰符(>>>)。 如果不能识别命令 python, Windows 将认为没有安装 Python ,进⽽打开 Microsoft Store 或显⽰⼀条消息(如 “Python was not found” )。如果 Windows 打开了 Microsoft Store ,请将其关闭。最好使⽤ Python ⽹站提供 的官⽅安装程序,⽽不要使⽤ Microsoft 维护的安装程序。 最简单的解决⽅案是,在不对系统做任何修改的情况下尝试执⾏命令 py。

A.1 Windows 系统

A.1 Windows 系统 第 1 章介绍了如何使⽤ Python ⽹站提供的官⽅安装程序来安装 Python 。如 果执⾏安装程序后,⽆法运⾏ Python ,本节的故障排除说明将帮助你让 Python 恢复正常。 A.1.1 ⽤ py 代替 python 运⾏较新的 Python 安装程序后,如果在终端中执⾏命令 python,应该会 看到表⽰终端会话的提⽰符(>>>)。

这节解决什么:这一节主要解决《附录 A 安装及故障排除》里一个更具体的子问题:A.1 Windows 系统 该怎样落到实际代码或项目动作上。

怎么用到自己的系统:不要只把它当书中的小节标题,最好把它改写成一个你能亲手运行、修改或调试的微练习。

提醒:常见误区是只看懂例子表面流程,却没有把这一节抽成自己能迁移的规则。

A.2 macOS 系统

A.2 macOS 系统 在第 1 章的安装说明中,使⽤的是 Python ⽹站提供的安装程序。多年来, 官⽅安装程序都很稳定,但有些因素可能导致你偏离正轨。如果遇到⿇ 烦,可参阅本节提供的简单易⾏的解决⽅案。 A.2.1 不⼩⼼安装了 Apple 提供的 Python 版本 如果你在没有安装 Python 的系统中执⾏命令 python3,很可能出现⼀条消 息,指出需要安装命令⾏开发者⼯具( command line developer tools )。

这节解决什么:这一节主要解决《附录 A 安装及故障排除》里一个更具体的子问题:A.2 macOS 系统 该怎样落到实际代码或项目动作上。

怎么用到自己的系统:不要只把它当书中的小节标题,最好把它改写成一个你能亲手运行、修改或调试的微练习。

提醒:常见误区是只看懂例子表面流程,却没有把这一节抽成自己能迁移的规则。

A.3 Linux 系统

A.3 Linux 系统 ⼏乎所有的 Linux 系统都默认安装了 Python ,但如果⾃带的版本低于 Python 3.9 ,就需要安装最新的版本。如果你想使⽤最新的特性,如改进的 错误消息,也可安装最新的版本。下⾯的说明适⽤于⼤多数基于 apt 的系 统。

这节解决什么:这一节主要解决《附录 A 安装及故障排除》里一个更具体的子问题:A.3 Linux 系统 该怎样落到实际代码或项目动作上。

怎么用到自己的系统:不要只把它当书中的小节标题,最好把它改写成一个你能亲手运行、修改或调试的微练习。

提醒:常见误区是只看懂例子表面流程,却没有把这一节抽成自己能迁移的规则。

A.4 检查使用的是哪个版本

A.4 检查使⽤的是哪个版本 如果在运⾏ Python 或安装额外的包的过程中遇到⿇烦,知道使⽤的是哪个 Python 版本会很有帮助。你的系统中可能安装了多个 Python 版本,导致你 不知道当前使⽤的是哪个版本。 在这种情况下,可在终端窗⼝中执⾏如下命令: $ python --version Python 3.11.0 输出准确地指出了命令 python 指向的是哪个版本。你也可以使⽤更简短 的命令 python -V,输出与上述命令相同。

这节解决什么:这一节主要解决《附录 A 安装及故障排除》里一个更具体的子问题:A.4 检查使用的是哪个版本 该怎样落到实际代码或项目动作上。

怎么用到自己的系统:不要只把它当书中的小节标题,最好把它改写成一个你能亲手运行、修改或调试的微练习。

提醒:常见误区是只看懂例子表面流程,却没有把这一节抽成自己能迁移的规则。

A.5 Python 关键字和内置函数

A.5 Python 关键字和内置函数 Python 包含⼀系列关键字和内置函数,在编程中命名时知道这些关键字和 内置函数很重要:既不能使⽤ Python 关键字,也不应使⽤ Python 内置函数 名,否则将覆盖相应的内置函数。 本节将列出 Python 关键字和内置函数的名称,让你知道应避免哪些命名。

这节解决什么:这一节主要解决《附录 A 安装及故障排除》里一个更具体的子问题:A.5 Python 关键字和内置函数 该怎样落到实际代码或项目动作上。

怎么用到自己的系统:不要只把它当书中的小节标题,最好把它改写成一个你能亲手运行、修改或调试的微练习。

提醒:常见误区是只看懂例子表面流程,却没有把这一节抽成自己能迁移的规则。

辨析题

为什么排错能力会在入门阶段就如此重要?

本章图版学习路径

环境稳定比背更多语法更值钱

排错不是意外插曲,而是开发能力本身