Python 安装与环境配置详细教程

注意：若输入 python 弹出微软商店，请将 Python 路径上移至 Microsoft Store 之前。

五、包管理工具 Pip 配置

Pip 是 Python 的包管理工具，用于安装第三方库。

1. 更新 Pip

为避免兼容性问题，首次使用前建议升级：

python -m pip install --upgrade pip

2. 配置镜像源

国内网络访问 PyPI 较慢，可配置国内镜像源加速下载。

• 临时指定：

  pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple
  

• 永久配置： 在用户目录下创建 pip.ini (Windows) 或 pip.conf (Linux/Mac)，内容如下：

  [global]
  index-url = https://pypi.tuna.tsinghua.edu.cn/simple
  trusted-host = pypi.tuna.tsinghua.edu.cn
  

六、多版本共存管理

当需要同时使用多个 Python 版本时，可采用以下方法：

1. 重命名执行文件

复制 python.exe 并重命名为 python3.8.exe，在命令行直接调用特定版本。

2. 使用 py 启动器 (Windows)

Windows 安装程序自带 py 启动器，可直接指定版本：

py -3.9 script.py
py -2.7 script.py

七、虚拟环境 (Virtual Environment)

为避免不同项目间的依赖冲突，强烈建议使用虚拟环境。

1. 创建虚拟环境

在项目目录下：

python -m venv venv

2. 激活虚拟环境

• Windows CMD：

  venv\Scripts\activate.bat
  

• PowerShell / Mac / Linux：

  source venv/bin/activate
  

激活后命令行前会出现 (venv) 标识。

3. 导出与导入依赖

• 导出：

  pip freeze > requirements.txt
  

• 导入：

  pip install -r requirements.txt
  

八、开发工具推荐

1. Jupyter Notebook

适合数据分析和交互式代码练习。安装命令：

pip install jupyter
jupyter notebook

2. VS Code (Visual Studio Code)

轻量级且插件丰富，配合 Python 插件可实现智能补全、调试等功能，是目前最流行的编辑器之一。

3. PyCharm

功能强大的专业 IDE，分为社区版（免费）和专业版（付费），适合大型项目开发。

九、常见问题排查

1. Command 'python' is not recognized：检查环境变量 Path 是否包含 Python 目录，或尝试使用 python3。
2. Permission Denied：在 Windows 以管理员身份运行 CMD，或在 Linux/Mac 使用 sudo。
3. SSL Error：检查系统时间是否正确，或配置镜像源时忽略 SSL 验证（不推荐生产环境）。

十、总结

完成上述步骤后，您已拥有可用的 Python 开发环境。建议定期更新 Python 和 Pip 以保持安全性。对于进阶学习，可进一步探索 Conda 环境管理、Docker 容器化部署等高级主题。