Python 环境搭建与版本检查

Python 项目最常见的问题通常不是语法，而是“命令调用了哪个解释器”“包装到了哪个环境”。因此，开始写代码前先把解释器、包管理器和虚拟环境理清楚。

检查解释器#

1
python --version
2
python -c "import sys; print(sys.executable)"

在部分 Linux 发行版中命令名是 python3：

1
python3 --version
2
python3 -c "import sys; print(sys.executable)"

不要只看版本号，还要看可执行文件路径。系统 Python、Homebrew Python、pyenv 与虚拟环境可能同时存在。

创建项目目录#

1
mkdir hello-python
2
cd hello-python
3
python -m venv .venv

激活环境：

1
# Linux / macOS
2
source .venv/bin/activate
3

4
# Windows PowerShell
5
.venv\Scripts\Activate.ps1

激活后再次检查：

1
python -c "import sys; print(sys.prefix)"
2
python -m pip --version

推荐使用 python -m pip，这样可以明确由当前解释器运行 pip，减少“pip 和 python 指向不同环境”的问题。

安装与记录依赖#

1
python -m pip install --upgrade pip
2
python -m pip install requests
3
python -m pip freeze > requirements.txt

在另一台机器恢复：

1
python -m venv .venv
2
source .venv/bin/activate
3
python -m pip install -r requirements.txt

pip freeze 适合记录当前环境快照。正式项目也可以使用 pyproject.toml 管理直接依赖，把锁定版本交给专门的依赖工具处理。

第一个脚本#

创建 main.py：

1
from pathlib import Path
2

3

4
def main() -> None:
5
    project_dir = Path.cwd()
6
    print(f"Python 环境正常，当前目录：{project_dir}")
7

8

9
if __name__ == "__main__":
10
    main()

运行：

1
python main.py

常见排查#

1
which python       # Linux / macOS
2
where python       # Windows
3
python -m site
4
python -m pip list

遇到导入失败时，先确认当前解释器路径，再确认包是否安装在这个解释器对应的环境中。

开发动态

检查解释器#

创建项目目录#

安装与记录依赖#

第一个脚本#

常见排查#

参考资料#