通过

在 Windows 上设置Python开发环境

在几分钟内在Windows上准备好Python环境 - 使用 winget 从命令行安装或手动设置环境。 需要具备以下条件：

  • Python – 当前稳定的Python运行时（3.14 或更高版本）
  • Visual Studio Code – 轻型功能强大的代码编辑器
  • 适用于 Visual Studio Code 的 Python 扩展 – 添加了对 Python 语言的支持、调试、代码检查等功能

  1. 在Windows 终端中打开 PowerShell 并安装Python：

    winget install Python.Python.3.14

  2. 安装 Visual Studio Code：

    winget install Microsoft.VisualStudioCode

  3. 关闭并重新打开 PowerShell，然后验证是否已安装Python：

    python --version

  4. 打开 VS Code 并从 VS Code 市场安装 Python 扩展。

现已准备好进行Python开发。

开始使用 Python

常见问题

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

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

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

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

关注 StackOverflow 上的讨论

使用 WSL 安装 pip 时遇到问题

在 适用于 Linux 的 Windows 子系统 （WSL 或 WSL2） 上使用 pip 安装包（如 Flask），例如 python3 -m pip install 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 查看可以使用哪些版本。 HOWEVER，仅当使用从 python.org 安装的 Python 版本时，py.exe 启动器才起作用。从Microsoft Store安装Python时，py 命令不包含。 对于 Linux、macOS、WSL 和 Microsoft Store 版本的 Python，应使用 python3 （或 python3.7） 命令。

为什么运行 python.exe 会打开 Microsoft Store？

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

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

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

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

为何当我复制粘贴文件路径时，它们在Python中不起作用？

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

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

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

什么是 PYTHONPATH？

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

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

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

不建议通过 Environment Variables 设置将此变量全局设置，因为这可能会被任何版本的 Python 使用，而不是您打算使用的版本。

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

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

Azure Kubernetes 服务 (AKS)使你能够在按需缩放资源的同时部署和管理容器化应用程序。

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

VS Code 具有内置的 Settings Sync，可用于使用GitHub或Microsoft 帐户跨计算机共享设置、键绑定、扩展等。 不需要扩展。

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

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

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

一些键盘按钮和系统快捷方式在Windows计算机和 Macintosh 之间略有不同。 此 Mac 到Windows转换指南涵盖了基础知识。

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