杰瑞科技汇

Windows下Python环境搭建如何操作?

目录

  1. 第一步:下载 Python 安装包
  2. 第二步:安装 Python (关键步骤)
  3. 第三步:验证安装与环境配置
  4. 第四步:选择并配置代码编辑器
  5. 第五步:编写并运行你的第一个 Python 程序
  6. 第六步:使用虚拟环境 (最佳实践)
  7. 第七步:包管理 (使用 pip)
  8. 常见问题与解决方案

第一步:下载 Python 安装包

  1. 访问官网:打开浏览器,访问 Python 官方下载页面:https://www.python.org/downloads/windows/
  2. 选择版本
    • 推荐新手:下载最新的 稳定版,页面通常会高亮显示 "Latest Python 3 Release",Python 3.12.x,新版本通常包含更多新特性和性能优化,并且对旧版本的 Bug 修复更及时。
    • 注意:请确保下载的是 Python 3.x 版本,而不是 Python 2.x,Python 2.x 已在 2025 年停止官方支持,不建议新项目使用。
  3. 下载安装包
    • 你会看到两个选项:"Download x86-64 installer""Download x86 installer"
    • x86-64 installer:这是 64 位版本的安装包,如果你的电脑是近几年购买的,几乎可以肯定是 64 位系统。请优先选择这个版本。
    • x86 installer:这是 32 位版本的安装包,仅用于非常老旧的电脑。

第二步:安装 Python (最关键的一步)

双击你下载的 .exe 文件,开始安装,请务必勾选以下两个选项,这能省去你后续很多麻烦。

Windows下Python环境搭建如何操作?-图1
(图片来源网络,侵删)
  1. 勾选 "Add Python to PATH"

    • 这是最重要的选项! 勾选它后,你就可以在 Windows 的命令提示符 或 PowerShell 中直接输入 python 命令,而不需要每次都输入完整的安装路径,如果不勾选,系统将无法识别 python 命令。
  2. 选择 "Install Now" (推荐新手)

    这会使用默认设置进行安装,包括将 Python 安装到你的用户目录下,这通常不需要管理员权限,非常方便。

  3. (可选) 选择 "Customize installation"

    Windows下Python环境搭建如何操作?-图2
    (图片来源网络,侵删)

    如果你需要安装到特定位置、修改文档关联或选择性地安装某些组件,可以点击这个选项,对于新手,默认安装即可。

  4. 等待安装完成:点击 "Install Now" 后,等待安装程序完成即可,完成后会显示一个 "Setup was successful" 的提示,点击 "Close" 关闭。


第三步:验证安装与环境配置

安装完成后,我们需要验证 Python 是否正确安装,并且环境变量是否配置成功。

  1. 打开命令行工具

    Windows下Python环境搭建如何操作?-图3
    (图片来源网络,侵删)
    • Win + S 键,搜索 "cmd" 或 "PowerShell",然后打开 "命令提示符" 或 "Windows PowerShell"。
  2. 检查 Python 版本

    • 在打开的黑色窗口中,输入以下命令并按回车:
      python --version
    • 如果看到类似 Python 3.12.0 的输出,恭喜你!Python 已经成功安装并且系统可以找到它。
    • 如果提示 'python' 不是内部或外部命令...,说明你没有在安装时勾选 "Add Python to PATH",别担心,我们可以手动添加。
  3. 手动添加环境变量 (如果需要)

    • 在 Windows 搜索栏中搜索 “编辑系统环境变量”,然后打开它。
    • 在弹出的“系统属性”窗口中,点击右下角的“环境变量...”按钮。
    • 在“系统变量”部分,找到名为 Path 的变量,选中它,然后点击“编辑...”。
    • 在“编辑环境变量”窗口中,点击“新建”,然后粘贴你的 Python 安装路径,通常是 C:\Users\<你的用户名>\AppData\Local\Programs\Python\Python3x (C:\Users\JohnDoe\AppData\Local\Programs\Python\Python312)。
    • 再点击“新建”,粘贴 Python 的 Scripts 路径,通常是 C:\Users\<你的用户名>\AppData\Local\Programs\Python\Python3x\Scripts
    • 确保这两个新路径在列表的顶部,然后一路点击“确定”保存所有更改。
    • 重要:关闭所有已打开的命令行窗口,然后重新打开一个新的,再次运行 python --version 命令。
  4. 检查 pip

    • pip 是 Python 的包管理工具,随 Python 一起安装,在命令行中输入:
      pip --version
    • 如果能看到版本信息,说明 pip 也配置好了。

第四步:选择并配置代码编辑器

光有命令行是不够的,你需要一个专门的工具来编写和编辑 Python 代码,这里推荐两款目前最主流的工具。

推荐选项 1:Visual Studio Code (VS Code) - 强大且免费

  1. 下载与安装:访问 https://code.visualstudio.com/,下载并安装 Windows 版本,安装时,你可以选择默认安装,也可以勾选 "Add to PATH"。
  2. 安装 Python 扩展
    • 打开 VS Code。
    • 点击左侧活动栏的“扩展”图标(或按 Ctrl+Shift+X)。
    • 在搜索框中输入 "Python"。
    • 找到由 Microsoft 发布的 Python 扩展,点击“安装”。
  3. 配置解释器
    • VS Code 需要知道要使用哪个 Python 环境,安装完扩展后,VS Code 通常会自动检测到你的 Python 安装。
    • 你也可以手动指定:按 Ctrl+Shift+P,输入 "Python: Select Interpreter",然后选择你刚刚安装的 Python 版本。

推荐选项 2:PyCharm Community Edition - 专为 Python 设计

  1. 下载与安装:访问 https://www.jetbrains.com/pycharm/download/,下载免费的 "Community" 社区版。
  2. 安装与配置
    • 安装过程比较直观,一路点击 "Next" 即可。
    • 首次启动时,PyCharm 会引导你创建一个新的项目,它会自动检测到你系统中的 Python 解释器。

第五步:编写并运行你的第一个 Python 程序

我们使用 VS Code 作为示例。

  1. 创建项目文件夹:在你的电脑上创建一个文件夹,D:\MyPythonProjects
  2. 在 VS Code 中打开文件夹:打开 VS Code,文件 -> 打开文件夹,选择你刚刚创建的 MyPythonProjects 文件夹。
  3. 创建新文件:在左侧的文件资源管理器中,点击“新建文件”按钮,命名为 hello.py
  4. 编写代码:在 hello.py 文件中输入以下代码:
    print("Hello, World! 欢迎来到 Python 世界!")
  5. 运行代码
    • 方法一 (推荐):在代码编辑器中,点击右上角的“运行”三角形按钮(或按 Ctrl+F5)。
    • 方法二:在 VS Code 中打开一个集成终端(终端 -> 新终端),然后输入 python hello.py 并按回车。
  6. 查看结果:在 VS Code 的终端窗口或输出窗口中,你应该能看到:
    Hello, World! 欢迎来到 Python 世界!

第六步:使用虚拟环境 (最佳实践)

当你开始开发多个项目时,不同项目可能需要不同版本的库(依赖包),虚拟环境可以为每个项目创建一个独立的、干净的 Python 环境,避免版本冲突。

  1. 在项目文件夹中创建虚拟环境

    • 在 VS Code 中打开你的项目文件夹(如 MyPythonProjects)。
    • 打开终端(终端 -> 新终端)。
    • 在终端中输入以下命令并按回车:
      # myenv 是虚拟环境的名字,你可以自定义
      python -m venv myenv
    • 这时,你的项目文件夹下会多出一个名为 myenv 的文件夹。
  2. 激活虚拟环境

    • 在命令提示符 中
      myenv\Scripts\activate.bat
    • 在 PowerShell 中 (如果策略不允许,可能需要先执行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process):
      .\myenv\Scripts\Activate.ps1
    • 激活成功后,你的终端提示符前面会出现 (myenv),这表示你当前正在虚拟环境中工作。
  3. 在虚拟环境中工作

    • 现在当你使用 pip 安装的任何包,都只会安装在 myenv 环境中,不会影响你的全局 Python 环境。
    • 当你完成工作后,可以通过输入 deactivate 命令来退出虚拟环境。

第七步:包管理 (使用 pip)

pip 是用来安装和管理第三方库的工具。

  1. 安装包

    • 基本语法:pip install <包名>
    • 安装一个非常流行的数据处理库 pandas
      pip install pandas
    • 最佳实践:始终在虚拟环境中安装包。
  2. 卸载包

    pip uninstall <包名>
  3. 查看已安装的包

    pip list
  4. 导出和安装依赖列表 (项目协作必备)

    • 当你完成项目开发后,可以将所有依赖包的列表导出到一个文件中,方便他人或未来的你快速重建环境。
    • 导出
      pip freeze > requirements.txt

      这会生成一个 requirements.txt 文件,里面列出了所有已安装的包及其版本。

    • 安装
      pip install -r requirements.txt

      这会读取 requirements.txt 文件并安装其中列出的所有包。


第八步:常见问题与解决方案

  1. 问题pip 命令执行很慢,或者提示连接超时。

    • 原因:默认从国外的 PyPI 源下载,国内访问较慢。
    • 解决方案:使用国内镜像源,临时使用:
      pip install -i https://pypi.tuna.tsinghua.edu.cn/simple some-package

      设为默认(推荐):

      pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

      常用的国内镜像源:清华大学、阿里云、中国科技大学。

  2. 问题:VS Code 无法识别 Python 解释器,或者提示 "No Python interpreter found"。

    • 解决方案
      1. 确保你已经安装了 Python 并勾选了 "Add to PATH"。
      2. 确保你已经安装了 VS Code 的 Python 扩展。
      3. Ctrl+Shift+P,输入 "Python: Select Interpreter",然后手动选择你的 Python 路径。
  3. 问题:运行 .py 文件时,一闪而过。

    • 原因:程序运行完了,命令行窗口自动关闭了。
    • 解决方案
      1. 在代码最后添加 input()os.system("pause") 来暂停程序。
      2. 直接在命令行中运行 python your_script.py,这样窗口会保持打开直到你手动关闭。

恭喜你!按照以上步骤,你已经成功在 Windows 上搭建了一个功能完备的 Python 开发环境,现在你可以:

  • 使用 Python 进行编程。
  • 使用 VS Code 或 PyCharm 作为你的代码编辑器。
  • 使用 pip 安装和管理项目所需的库。
  • 使用虚拟环境来保持项目的整洁和独立。

就可以开始你的 Python 学习和开发之旅了!祝你编码愉快!

分享:
扫描分享到社交APP
上一篇
下一篇