通过

在 Windows 上设置 Python 开发环境

在几分钟内在 Windows 上准备好 Python 环境 - 手动设置它，或使用 winget 自动完成所有内容。 需要具备以下条件：

  • Python 3.13 – 最新的 Python 运行时
  • Visual Studio Code – 轻型功能强大的代码编辑器
  • 用于 Visual Studio Code 的 Python 扩展 - 添加 Python 语言支持、调试、linting 等

下面的 WinGet 配置文件 会自动安装上面列出的所有内容。

开始之前：

  1. 在 Windows 终端中打开 PowerShell 并运行以下命令：

    winget configure -f https://aka.ms/python-config

  2. 配置启动时，终端窗口会显示安装步骤和所需安装。 查看它们，然后选择 [Y] 是或 [N] 否继续进行确认。

  3. 已安装所需的工作负荷。 通过运行 python --version来验证设置。

现已准备好进行 Python 开发。

开始学习 Python

常见问题

使用 pip install 安装软件包时出现问题

安装失败的原因有很多-在许多情况下，正确的解决方案是联系包开发人员。

一个常见的问题原因是尝试安装到您无权修改的位置。 例如，默认安装位置可能需要管理权限，但默认情况下 Python 将不包含这些权限。 最佳解决方案是创建 虚拟环境 并安装该环境。

某些包包括需要 C 或 C++ 编译器安装的本机代码。 通常，包开发人员应发布预编译的版本，但通常不发布。 如果 安装适用于 Visual Studio 的生成工具 并选择 C++ 选项，则其中一些包可能会起作用，但在大多数情况下，需要联系包开发人员。

关注 StackOverflow 上的讨论

使用 WSL 安装 pip 时遇到问题

例如 python3 -m pip install flask，在适用于 Linux 的 Windows 子系统（WSL 或 WSL2）上安装带有 pip 的包（如 Flask），可能会遇到如下错误：

WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None))
after connection broken by 'NewConnectionError('<urllib3.connection.VerifiedHTTPSConnection
object at 0x7f655471da30>: Failed to establish a new connection: [Errno -3]
Temporary failure in name resolution')': /simple/flask/

除非你运行的是后市场防火墙，否则可能的解决方案只是重新安装 pip：

sudo apt -y purge python3-pip
sudo python3 -m pip uninstall pip
sudo apt -y install python3-pip --fix-missing
什么是 py.exe？

你最终可能会在计算机上安装多个版本的 Python，因为你正在处理不同类型的 Python 项目。 由于所有这些都使用 python 命令，因此你使用的 Python 版本可能并不明显。 作为标准，建议使用 python3 命令（或 python3.7 选择特定版本）。

py.exe 启动器将自动选择已安装的最新版本的 Python。 还可以使用诸如 py -3.7 选择特定版本的命令，或 py --list 查看可以使用哪些版本。 但是，仅当使用从 python.org 安装的 Python 版本时，py.exe 启动器才起作用。从 Microsoft 应用商店安装 Python 时，py不包括该命令。 对于 Linux、macOS、WSL 和 Microsoft Store 版本的 Python，应使用 python3 （或 python3.7） 命令。

为什么运行 python.exe 打开Microsoft应用商店？

为了帮助新用户找到良好的 Python 安装，我们添加了 Windows 的快捷方式，该快捷方式将直接转到 Microsoft 应用商店中发布的社区包的最新版本。 无需管理员权限即可轻松安装此包，并将默认的 python 命令和 python3 命令替换为真实的命令。

使用任何命令行参数运行快捷方式可执行文件将返回错误代码，指示未安装 Python。 这是为了防止批处理文件和脚本在可能不打算时打开应用商店应用。

如果使用 python.org 中的安装程序安装 Python，并选择“添加到 PATH”选项，则新 python 命令将优先于快捷方式。 请注意，其他安装程序添加的python优先级要低于内置快捷方式。

可以通过从“开始”打开“管理应用执行别名”，找到“应用安装程序”Python 条目并将其切换到“关”来禁用快捷方式，而无需安装 Python。

复制粘贴文件时，为什么文件路径在 Python 中不起作用？

Python 字符串对特殊字符使用“转义”。 例如，若要在字符串中插入新行字符，请键入 \n。 由于 Windows 上的文件路径使用反斜杠，因此某些部分可能会转换为特殊字符。

若要将路径粘贴为 Python 中的字符串，请添加 r 前缀。 这表示它是一个 raw 字符串，除了“（可能需要删除路径中的最后一个反斜杠）之外，不会使用转义字符。 因此，路径可能如下所示： r"C:\Users\MyName\Documents\Document.txt"

在 Python 中使用路径时，建议使用标准 pathlib 模块。 这样，便可以将字符串转换为丰富的 Path 对象，该对象可以一致地执行路径操作，无论它使用正斜杠还是反斜杠，使代码在不同的操作系统中都能更好地工作。

什么是 PYTHONPATH？

Python 使用 PYTHONPATH 环境变量指定可从中导入模块的目录列表。 运行时，可以检查 sys.path 变量，以查看导入内容时将搜索哪些目录。

若要从命令提示符设置此变量，请使用： set PYTHONPATH=list;of;paths

若要从 PowerShell 设置此变量，请使用： $env:PYTHONPATH='list;of;paths' 在启动 Python 之前。

不建议通过环境变量全局设定此变量，因为它可能会被任何版本的 Python 使用，而不是您打算使用的那个版本。

在哪里可以找到有关打包和部署的帮助？

Docker： VSCode 扩展 可帮助你使用 Dockerfile 和docker-compose.yml模板快速打包和部署（为项目生成正确的 Docker 文件）。

使用 Azure Kubernetes 服务（AKS）， 可以在按需缩放资源时部署和管理容器化应用程序。

如果需要跨不同计算机工作，该怎么办？

设置同步 允许使用 GitHub 跨不同安装同步 VS Code 设置。 如果在多台计算机上工作，这有助于使环境设置在这些计算机之间保持一致。

如果我习惯使用 PyCharm、Atom、Sublime Text、Emacs 或 Vim，该怎么办？

VSCode 扩展 Keymaps 可以帮助您的环境感觉更加自然。

Mac 快捷键如何映射到 Windows 快捷键？

Windows 计算机和 Macintosh 之间的某些键盘按钮和系统快捷方式略有不同。 本 Mac 到 Windows 转换指南 介绍了基础知识。

在 VS Code 中可以在哪里了解有关使用 Python 的详细信息？
  • 在 VS Code 中编辑 Python：详细了解如何利用 VS Code 对 Python 的自动完成和 IntelliSense 支持，包括如何自定义其行为...或只是关闭它们。
  • Linting Python：Linting 是运行一个程序的过程，该程序将分析代码中的潜在错误。 了解 VS Code 为 Python 提供的不同形式的 linting 支持，以及如何设置它。
  • 调试 Python：调试是识别和删除计算机程序中的错误的过程。 本文介绍如何使用 VS Code 初始化和配置 Python 调试、如何设置和验证断点、附加本地脚本、对不同应用类型或远程计算机上执行调试，以及一些基本故障排除。
  • 单元测试 Python：介绍一些背景，说明单元测试的含义、示例演练、启用测试框架、创建和运行测试、调试测试和测试配置设置。
  • Last updated on