Python 环境管理:先弄清楚代码在哪里运行

遇到“明明安装了却找不到包”,先检查解释器,再讨论依赖。一个最小的排查笔记。

这是一篇用于展示排版与写作方式的示例文章,不代表博主的个人经历或研究成果。

同一台电脑上可能有多个 Python 解释器。命令行、编辑器和 Notebook 使用的解释器不一致时,就容易出现“已经安装,却无法导入”的情况。

先确定解释器

在出错的环境里运行:

import sys

print(sys.executable)
print(sys.version)

输出的解释器路径,比“我记得自己用的是哪个环境”更可靠。

给项目一个独立环境

创建虚拟环境

在项目目录中建立虚拟环境:

python -m venv .venv

激活环境

激活方式与系统、终端有关。

Windows PowerShell

使用 .venv\Scripts\Activate.ps1。

macOS 与 Linux

常见 shell 下可以使用 source .venv/bin/activate。

确认当前解释器

激活后,再检查一次 sys.executable,确认指向刚创建的环境。

让安装与运行指向同一个 Python

python -m pip --version
python -m pip install requests
python -c "import requests; print(requests.__version__)"

使用 python -m pip,可以明确让当前的 Python 来运行 pip。编辑器里也需要选择同一个解释器。

留下可以复现的记录

在项目说明里写下 Python 版本、安装步骤和启动方式。依赖清单最好在干净的项目环境中生成,避免混入其他项目的包。

参考:Python 官方 venv 文档。

在笔记里找一找

输入关键词,查找相关文章

↑ ↓ 选择文章 · Enter 打开文章 · Esc 关闭