Python / 知识点

Python 开发速查手册

手册条目

确认当前终端实际调用的 Python 版本及运行环境。

查看 Python 版本

用于确认当前终端中 python 实际启动的版本,并同时核对解释器路径。排查“本机已安装新版本,但项目仍运行旧版本”时,先执行这一组命令。

基本语法

bash
python --version
python -c "import sys; print(sys.version.split()[0]); print(sys.executable)"

预期输出

text
Python 3.12.4
3.12.4
<PATH>

第一行是命令入口报告的版本;第二行来自当前解释器运行时;第三行是本次进程使用的解释器路径。<PATH> 会因系统、虚拟环境和安装方式不同而变化。

高频用法

只需快速确认版本时使用 --version 或等价的 -V 选项。排查环境问题时必须同时读取 sys.executable,因为相同版本号可能来自不同的系统安装或虚拟环境。

进入虚拟环境后应重新检查一次。若路径位于项目的 .venv、venv 或 Conda 环境目录,说明当前命令已经使用该环境;仍指向系统目录则通常是环境未激活或命令被别名、shim 覆盖。

风险与边界

python --version 只反映当前终端解析到的命令,不代表机器上所有 Python 安装。触发条件是存在多个版本、虚拟环境、pyenv、Conda 或 shell 别名;可能后果是安装依赖和运行程序落到不同解释器。安全做法是同时读取 sys.executable,并用该完整路径执行后续命令。

不要仅凭 pip --version 推断 Python 版本,因为独立的 pip 命令可能绑定到另一套环境。安装包时优先使用 python -m pip 形式,让 pip 跟随当前解释器运行。

排障清单

  • 出现“command not found”时,在类 Unix 系统检查是否仅提供 python3,在 Windows 检查是否安装了 Python Launcher。
  • 版本与预期不一致时,先退出并重新激活虚拟环境,再检查 sys.executable。
  • IDE 与终端结果不同,说明 IDE 选择了另一解释器,应在项目解释器设置中对齐路径。

速查结论:版本号回答“运行的是哪一版”,sys.executable 回答“具体从哪里运行”。

目录与阅读设置

记录一个想法

Python 开发速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通