Skip to content

[v22.x backport] build: support Python 3.14#61818

Open
MikeMcC399 wants to merge 1 commit intonodejs:v22.x-stagingfrom
MikeMcC399:backport-59983-to-v22.x
Open

[v22.x backport] build: support Python 3.14#61818
MikeMcC399 wants to merge 1 commit intonodejs:v22.x-stagingfrom
MikeMcC399:backport-59983-to-v22.x

Conversation

@MikeMcC399
Copy link
Contributor

Python v3.14 -- October 7th

PR-URL: #59983
Reviewed-By: Marco Ippolito marcoippolito54@gmail.coma
Reviewed-By: Stefan Stojanovic stefan.stojanovic@janeasystems.com
Reviewed-By: Stewart X Addison sxa@redhat.com


Refs: #60874
Refs: #61370

Situation

Node.js 22.x (Maintenance LTS) build fails with Python 3.14.

Python 3.14 is:

  • the current highest supported Python version
  • the version installed on Windows using py install default
  • the system-default on Fedora 43

On Windows 11 25H2 with prerequisites including Python 3.14.x installed:

git switch v22.x
.\vcbuild

fails with:

Node.js configure: Found Python 3.14.3...
Please use python3.13 or python3.12 or python3.11 or python3.10 or python3.9 or python3.8.
Failed to create vc project files.

Change

Backports #59983 as modified through the backport PR for v24.x #61370 and commit 1f64d68 in the v24.x branch, resolving merge commits.

The commit message from the backport needs to be modified. The original message "build: test on Python 3.14 release candidate 3" was not entirely accurate, as the commit not only tested on Python 3.14, it also provided support for Python 3.14. Additionally, by the time the PR was merged, Python 3.14 was in GA status, and no longer a release candidate.

The changed commit message is:

build: support Python 3.14

Verification

For both Windows and Fedora confirm

  • there is no error concerning the version of Python
  • the build completes successfully

Windows

On Windows 11 25H2 manually install prerequisites according to Windows - Option 1: Manual install and using Visual Studio 2022 Build Tools Edition.

Only Python 3.14.x should be shown installed by:

py list

In a PowerShell 7 terminal, execute:

.\vcbuild

Fedora

On Fedora 43, install prerequisites according to Unix prerequisites:

sudo dnf update
sudo dnf install python3 gcc-c++ make python3-pip

Execute:

./configure
make -j4

@nodejs-github-bot
Copy link
Collaborator

Review requested:

  • @nodejs/actions
  • @nodejs/security-wg

@nodejs-github-bot nodejs-github-bot added build Issues and PRs related to build files or the CI. meta Issues and PRs related to the general management of the project. needs-ci PRs that need a full CI run. v22.x Issues that can be reproduced on v22.x or PRs targeting the v22.x-staging branch. labels Feb 14, 2026
Python v3.14 -- October 7th
* https://www.python.org/download/pre-releases
* https://www.python.org/downloads/release/python-3140rc3

PR-URL: nodejs#59983
Backport-PR-URL: nodejs#61370
Co-authored-by:
 Mike McCready <66998419+MikeMcC399@users.noreply.github.com>
Reviewed-By: Marco Ippolito <marcoippolito54@gmail.com>
Reviewed-By: Stefan Stojanovic <stefan.stojanovic@janeasystems.com>
Reviewed-By: Stewart X Addison <sxa@redhat.com>
Refs: nodejs#60874
@MikeMcC399 MikeMcC399 force-pushed the backport-59983-to-v22.x branch from f522ca6 to 0cacae1 Compare February 14, 2026 16:15
@MikeMcC399 MikeMcC399 marked this pull request as ready for review February 14, 2026 16:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

build Issues and PRs related to build files or the CI. meta Issues and PRs related to the general management of the project. needs-ci PRs that need a full CI run. v22.x Issues that can be reproduced on v22.x or PRs targeting the v22.x-staging branch.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants