30-seconds-of-code Python 环境配置：将 Python 3 与 pip 3 设置为默认版本

• 教程
• 文档

在 Python 2.x 与 3.x 并存的开发环境中，最令人头疼的问题之一就是"到底该敲python还是python3"。本文基于 30-seconds-of-code 仓库中 setup-python3-pip3-as-default.md 的核心思路，完整讲解如何通过which定位解释器路径、用 shell 别名（alias）把python/pip永久指向 3.x 版本，并给出生效验证、常见坑位与仓库源码佐证。读完即可在自己的 Linux/macOS 环境中彻底告别版本混淆。

一、问题背景：为什么需要手动设置默认版本

在很长一段时间里，许多 Linux 发行版和 macOS 预装的系统 Python 仍是 2.x，而现代项目几乎都基于 Python 3。于是开发者的肌肉记忆经常踩坑：python意外进入了 Python 2 解释器，pip安装的包也落到了错误的环境。

30-seconds-of-code 的 Python 内容集合本身即以Python 3.6 及以上版本为基线——这一点可以从 python/index.yaml 中的描述得到确认（"contains helper functions for Python 3.6"）。因此，让本机默认的python、pip命令指向 3.x，是该集合所有代码片段能够顺利运行的前提条件。

解决思路并不复杂：先确认 3.x 可执行文件的真实路径，再通过 shell 别名把短命令映射过去。原文档将这套流程压缩为两条which命令和四条echo命令，下面逐步展开。

二、定位 Python 3 与 pip 3 的真实路径

一切配置都建立在"知道文件在哪"的基础上。使用which命令分别查询python3与pip3的安装位置：

which python3 # /usr/local/bin/python3 which pip3 # /usr/local/bin/pip3

which会在$PATH环境变量声明的目录列表中逐个查找可执行文件，并输出第一个命中项的绝对路径。不同系统的输出会有所不同，例如：

• Homebrew 安装的 Python 3 通常位于/usr/local/opt/python/libexec/bin/python3或/opt/homebrew/bin/python3；
• 官方安装包（python.org）默认安装在/Library/Frameworks/Python.framework/Versions/3.x/bin/python3（macOS）；
• apt/yum 等包管理器安装的多位于/usr/bin/python3（Linux）。

请务必以你机器上which的实际输出为准，不要照抄示例路径。记下这两条路径，下一步要把它们写进 shell 配置文件的别名里。

三、用 alias 将 python/pip 指向 3.x

拿到真实路径后，利用echo把别名追加到 shell 启动配置文件的末尾。根据你的默认 shell 环境选择目标文件：

# Linux 或其他 bash 环境 echo "alias python=/usr/local/bin/python3" >> ~/.bashrc echo "alias pip=/usr/local/bin/pip3" >> ~/.bashrc # macOS 或其他 zsh 环境 echo "alias python=/usr/local/bin/python3" >> ~/.zshrc echo "alias pip=/usr/local/bin/pip3" >> ~/.zshrc

其中>>表示以追加（append）方式写入，不会覆盖文件中已有的内容；双引号包裹的整行会被原样写入。需要说明两点：

1. 路径占位：上述示例沿用了原文档中的/usr/local/bin/python3，实际写入时请替换为你在第二步which得到的结果；
2. 环境区分：~/.bashrc与~/.zshrc分别对应 bash 与 zsh 的启动配置。如果你不确定自己用的是哪种 shell，可以执行echo $SHELL查看当前默认 shell，再决定追加到哪个文件。若两者都可能用到，两个文件都追加也无妨。

这一方案的原理是：shell 每次交互式启动时都会读取对应的 rc 文件，逐行注册其中的alias定义。此后在终端输入python时，shell 会在展开阶段将其替换为完整的绝对路径，从而"欺骗"命令行执行到 3.x 版本。

四、让配置立即生效并验证

新追加的别名只在下一次启动新终端会话时才会被加载。如果不想关闭重开终端，可以手动让当前会话重新读取配置文件：

source ~/.bashrc # 或 source ~/.zshrc

然后验证版本是否生效：

python --version # Python 3.x.y pip --version # pip 3.x.y from /usr/local/lib/python3.x/site-packages/pip (python 3.x)

当python --version输出的主版本号是 3 时，说明配置成功。至此，python与pip都已映射到 3.x 版本，后续安装包、运行脚本都不再需要记忆后缀。

五、alias 机制的两个注意事项

配置虽然简单，但理解 alias 的行为边界能帮你避免隐蔽问题。30-seconds-of-code 中另一篇与 shell 别名相关的文章 bash-alias-dollar-sign.md 恰好给出了关键提示：

• 别名只替换命令行的第一个词：alias 生效范围仅限于一条简单命令的开头位置，不会替换参数中的同名文本。因此alias python=...只会影响你直接在终端敲出的python，不会误伤脚本内部对python字符串的引用；
• 非交互式脚本不受影响：别名定义通常写在交互式 shell 的启动文件中，脚本文件第一行的 shebang（如#!/usr/bin/env python3）直接指定了解释器路径，不经过别名展开。所以这条方案主要解决"终端手动敲命令"的场景，不会破坏项目脚本的确定性。

六、在 30-seconds-of-code 仓库中的位置与佐证

该文档在仓库中对应一个标准的 Python 代码片段文件：

• 正文来源：content/snippets/python/s/setup-python3-pip3-as-default.md，frontmatter 中标记language: python、tags: [setup]，归类于s/目录下的环境设置类片段；
• 集合归属：它隶属于 content/collections/python/index.yaml 描述的 Python 内容集合，该集合明确面向 Python 3.6+，从侧面印证了"让默认命令指向 3.x"这一配置的必要性；
• 站点路由：content/redirects.yaml 中记录了/articles/s/setup-python3-pip3-as-default到/python/s/setup-python3-pip3-as-default的重定向，说明该片段在网站结构中长期存在并持续被引用；
• 内容模板：若希望撰写同类环境配置文章，可参照 content/snippets/python/snippet-template.md 的 frontmatter 结构（title、shortTitle、language、tags、cover、excerpt、listed、dateModified）。

七、进阶思路与适用前提

原文档提供的 alias 方案适用于"单机单 Python 3"的简单场景，它有几个明确的适用前提：

• 仅影响当前用户：写入~/.bashrc或~/.zshrc只对当前账户生效，不会改变系统级/usr/bin/python的指向，也不会影响sudo命令下的默认解释器；
• 路径必须真实存在：如果which python3返回空或报错，说明 3.x 尚未安装，应先通过包管理器或官方安装包完成安装；
• 适合长期稳定环境：当机器上存在多版本 Python 且需要频繁切换（如 pyenv、conda）时，别名反而可能造成干扰，此时更推荐使用版本管理工具。

对于大多数只需"记住一个命令"的场景，alias 方案以其零依赖、一条命令即可回滚（直接删除 rc 文件中对应行）的特点，依然是最轻量、最易理解的选择。

提示：本仓库为只读镜像，文章中涉及的所有命令均在你的本机 shell 环境中执行即可，无需对仓库做任何改动。

• 教程
• 文档