Skip to content

Commit 2e67afd

Browse files
Refresh Python dev environment docs for 2026 (#6501)
* Refresh Python docs: update to 3.14, fix VS build tools link, update Settings Sync to built-in * Fix version-pinned wording in Python setup guide Copilot flagged that coupling a specific version number to 'latest' will become inaccurate as newer versions ship. Changes: - Requirements bullet: 'Python 3.14 - The latest' -> 'The current stable (3.14 or later)' - Manual install step: 'Install Python 3.14' -> 'Install Python' (link already searches generically) Co-authored-by: Copilot <[email protected]> * Add winget configure --enable prerequisite step to Python setup guide The winget configure command requires extended features to be enabled before it can run. Without this, users get: 'Extended features are not enabled. Run winget configure --enable...' Fix: split into 4 explicit steps — enable, configure, confirm, verify. Also surfaced python --version as its own code block (was buried in prose). Fixes real user report from testing the docs. Co-authored-by: Copilot <[email protected]> * Replace winget configure with winget install for Python setup winget configure requires enabling extended features and relies on an external config file (aka.ms/python-config) that can silently fail. Replace with simple, reliable winget install commands: winget install Python.Python.3.14 winget install Microsoft.VisualStudioCode Also add 'restart terminal' step so PATH changes take effect, and rename tab from 'WinGet Configuration' to 'WinGet'. Co-authored-by: Copilot <[email protected]> --------- Co-authored-by: Copilot <[email protected]>
1 parent 8acb9f6 commit 2e67afd

1 file changed

Lines changed: 21 additions & 14 deletions

File tree

hub/dev-environment/python.md

Lines changed: 21 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,39 +2,46 @@
22
title: Python on Windows for beginners
33
description: A guide to help you get started if your brand new to using Python on Windows.
44
ms.topic: get-started
5-
ms.date: 07/03/2025
5+
ms.date: 03/23/2026
66
ms.custom: copilot-scenario-highlight
77
---
88

99
# Set up your Python development environment on Windows
1010

11-
Get your Python environment ready on Windows in minutes — set it up manually or automate everything with winget. You'll need the following:
11+
Get your Python environment ready on Windows in minutes — install from the command line with winget or set it up manually. You'll need the following:
1212

13-
- **Python 3.13** – The latest Python runtime
13+
- **Python** – The current stable Python runtime (3.14 or later)
1414
- **Visual Studio Code** – A lightweight, powerful code editor
1515
- **Python extension for Visual Studio Code** – Adds Python language support, debugging, linting, and more
1616

17-
#### [WinGet Configuration](#tab/winget)
17+
#### [WinGet](#tab/winget)
1818

19-
The [WinGet configuration file](https://aka.ms/python-config) below installs everything listed above automatically.
19+
1. Open PowerShell in Windows Terminal and install Python:
2020

21-
To get started:
21+
```powershell
22+
winget install Python.Python.3.14
23+
```
2224
23-
1. Open PowerShell in Windows Terminal and run the following command:
25+
2. Install Visual Studio Code:
2426
2527
```powershell
26-
winget configure -f https://aka.ms/python-config
28+
winget install Microsoft.VisualStudioCode
2729
```
28-
2. When the configuration starts, a terminal window shows the setup steps and required installs. Review them, then confirm by selecting [Y] Yes or [N] No to continue.
2930
30-
3. The required workloads are installed. Verify your setup by running `python --version`.
31+
3. Close and reopen PowerShell, then verify Python is installed:
32+
33+
```powershell
34+
python --version
35+
```
36+
37+
4. Open VS Code and install the [Python extension](https://marketplace.visualstudio.com/items?itemName=ms-python.python) from the VS Code Marketplace.
3138
3239
You're now ready for Python development.
3340
3441
3542
#### [Manual installation](#tab/manual)
3643
37-
1. **Install Python 3.13**: Install [Python 3 from the Microsoft Store](https://apps.microsoft.com/search?query=python). The Microsoft Store version automatically configures your PATH and provides automatic updates. Once installed, open PowerShell and run `python --version` to verify.
44+
1. **Install Python**: Install [Python from the Microsoft Store](https://apps.microsoft.com/search?query=python). The Microsoft Store version automatically configures your PATH and provides automatic updates. Once installed, open PowerShell and run `python --version` to verify.
3845
3946
2. **Install Visual Studio Code**: Download and install [Visual Studio Code](https://code.visualstudio.com).
4047
@@ -53,7 +60,7 @@ You're now ready for Python development.
5360
>
5461
> A common cause for trouble is trying to install into a location that you do not have permission to modify. For example, the default install location might require Administrative privileges, but by default Python will not have them. The best solution is to create a [virtual environment](https://docs.python.org/3/tutorial/venv.html) and install there.
5562
>
56-
> Some packages include native code that requires a C or C++ compiler to install. In general, package developers should publish pre-compiled versions, but often do not. Some of these packages might work if you [install Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019) and select the C++ option, however in most cases you will need to contact the package developer.
63+
> Some packages include native code that requires a C or C++ compiler to install. In general, package developers should publish pre-compiled versions, but often do not. Some of these packages might work if you [install Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio) and select the C++ option, however in most cases you will need to contact the package developer.
5764
>
5865
> [Follow the discussion on StackOverflow](https://stackoverflow.com/questions/4750806/how-do-i-install-pip-on-windows/12476379)
5966
@@ -133,7 +140,7 @@ You're now ready for Python development.
133140
134141
<details><summary>What if I need to work across different machines?</summary>
135142
136-
> [Settings Sync](https://marketplace.visualstudio.com/items?itemName=Shan.code-settings-sync) allows you to synchronize your VS Code settings across different installations using GitHub. If you work on different machines, this helps keep your environment consistent across them.
143+
> VS Code has built-in [Settings Sync](https://code.visualstudio.com/docs/configure/settings-sync) that lets you share your settings, keybindings, extensions, and more across machines using your GitHub or Microsoft account. No extension needed.
137144
138145
</details>
139146
@@ -156,4 +163,4 @@ You're now ready for Python development.
156163
> - [Debugging Python](https://code.visualstudio.com/docs/python/debugging): Debugging is the process of identifying and removing errors from a computer program. This article covers how to initialize and configure debugging for Python with VS Code, how to set and validate breakpoints, attach a local script, perform debugging for different app types or on a remote computer, and some basic troubleshooting.
157164
> - [Unit testing Python](https://code.visualstudio.com/docs/python/unit-testing): Covers some background explaining what unit testing means, an example walkthrough, enabling a test framework, creating and running your tests, debugging tests, and test configuration settings.
158165
159-
</details>
166+
</details>

0 commit comments

Comments
 (0)