# @bjia56/portable-python-3\.12 中文文档

规范地址：https://npmcn.com/package/%40bjia56/portable-python-3.12/

版本：0\.1\.42
npm 元数据更新时间：2026-10-30T02:21:25.007Z
中文译文更新时间：2026-11-08T09:32:05.427Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bjia56/portable-python-3.12
原文对照：https://npmcn.com/package/%40bjia56/portable-python-3.12/?lang=original
项目主页：https://github.com/bjia56/portable-python
源码仓库：https://github.com/bjia56/portable-python

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：618 kB，8 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2024-03-15T04:16:00.213Z
- 最新版本发布：2026-10-30T02:21:24.552Z
- 近 30 天下载量：1833（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：44（近 12 个月 2 个）

## 中文简介

便携式 Python 3.12

## 安装

```sh
npm install @bjia56/portable-python-3.12
```

也可以使用：`pnpm add @bjia56/portable-python-3.12`、`yarn add @bjia56/portable-python-3.12`、`bun add @bjia56/portable-python-3.12`

## README

# 便携式平面

![GitHub Downloads (all assets, all releases)](https://bjia56.github.io/stats/bjia56/portable-python/downloads_badge.svg) [![NPM Version](https://img.shields.io/npm/v/%40bjia56%2Fportable-python)](https://www.npmjs.com/package/@bjia56/portable-python)

该项目提供自成一体(因此,“便携式”) Python向各种目标平台和架构发布. 这些Python发行版可以被下载并提取到文件系统中的任何地方,使得安装变得轻而易举和可配置.

## 使用量

要启动, 请下载档案 [GitHub 发布](https://github.com/bjia56/portable-python/releases)。或者使用下列任何安装器:

-   `npm i @bjia56/portable-python-3.9`
-   `npm i @bjia56/portable-python-3.10`
-   `npm i @bjia56/portable-python-3.11`
-   `npm i @bjia56/portable-python-3.12`
-   `npm i @bjia56/portable-python-3.13`

例如,在Linux上通过bash:

```
$ wget -q https://github.com/bjia56/portable-python/releases/download/cpython-v3.12.6-build.5/python-headless-3.12.6-linux-x86_64.zip
$ unzip -qq python-headless-3.12.6-linux-x86_64.zip
$ ./python-headless-3.12.6-linux-x86_64/bin/python --version
Python 3.12.6
```

或者通过节点安装器:

```
$ npm i --silent @bjia56/portable-python-3.12
$ ./node_modules/@bjia56/portable-python-3.12/python-headless-3.12.6-linux-x86_64/bin/python --version
Python 3.12.6
```

或者通过节点:

```js
var pythonExe = require("@bjia56/portable-python-3.12");
var child_process = require("child_process");
console.log(child_process.execSync(`${pythonExe} --version`).toString());
```

## 可用分发量

目前,为下列目标建造了CPython 3.9, 3.10, 3.11, 3.12和 3.13:

-   Linux x86 64, i386, 无名64, 臂 [1个](https://npmcn.com/package/%40bjia56/portable-python-3.12/#readme-f1), riscv64, s390x, loongarch64, powerpc64le (glibc) (英语)
-   Windows x86 64, 无效64 [2个](https://npmcn.com/package/%40bjia56/portable-python-3.12/#readme-f2)
-   麦克OS x86 64, arm64 [3个](https://npmcn.com/package/%40bjia56/portable-python-3.12/#readme-f3)
-   免费BSD 14, 15 x86 64
-   索拉里斯 11 x86 64
-   宇宙政治图书馆 [页:1](https://npmcn.com/package/%40bjia56/portable-python-3.12/#readme-f4)

对于Linux CPython 架构,所需的最小 glibc 如下:

| 硬件架构 | 最小 glibc 版本 |
| --- | --- |
| x86 64 (韩语) | 2.17 联合国 |
| i386 (单位:千美元) | 2.17 联合国 |
| 存档64 | 2.17 联合国 |
| 手臂 | 2.17 联合国 |
| 危机64 | 2.27 (中文(简体) ) |
| s390x (英语) | 2.19 联合国 |
| 龙卷风64 | 第2.36条 |
| 电源pc64le | 2.19 联合国 |

除了"宇宙通"(Cosmopolitan libc built)外,所有CPython的分布,都有两种可用的变体: `full` 财务报告和审定财务报表 `headless`区别在于: `headless` 建筑不包括任何UI库(即:. `tkinter` 因此更适合非图式服务器安装.

PyPy和GraalPy发行版也作为官方上游发行的再包装版本提供. 尽管它们已经是便携式的,但为了方便和灵活起见,通过节点安装器提供了分布.

**1个** 手臂搭建了目标臂活6,具体来说就是"Raspberry Pi 1"的配置. 目前的臂部构造在旧的glibc(尽管有glibc 2.17的目标)上没有适当工作,但最近版的Raspbian像Debian pullseye(英语:Debian pullseye(英语:Debian pullsey))应该能提供一个新的足够glibc来工作. [↩](https://npmcn.com/package/%40bjia56/portable-python-3.12/#readme-a1)

**2个** Windows x86 64发行需要至少Windows 10,而arch64发行需要至少Windows 11. [↩](https://npmcn.com/package/%40bjia56/portable-python-3.12/#readme-a2)

**3个** MacOS发行版作为通用2提供,将同时工作于x86 64和arm64. 最低MacOS版本为x86 64上10.9个,arm64上11.0个. [↩](https://npmcn.com/package/%40bjia56/portable-python-3.12/#readme-a3)

**页:1** [宇宙政治图书馆](https://justine.lol/cosmopolitan/index.html) 构建是静态相联的,可能不支持所有的Python特性. 见Cosmopolitan Libc项目关于最低操作系统要求的文件. [↩](https://npmcn.com/package/%40bjia56/portable-python-3.12/#readme-a4)

## 许可证发放

该寄存器中的构建脚本和代码可用Apache-2.0许可证提供. 注意Python的编译涉及与其他库的链接,其中一些库可能包含不同的许可条款. 已知附属单位的许可证副本列于 `licenses` 每个 Python 分布的目录.

## 常见问题

### @bjia56/portable-python-3\.12 是什么？

便携式 Python 3\.12

### 如何安装 @bjia56/portable-python-3\.12？

在项目目录运行 npm install @bjia56/portable-python-3\.12，或使用 pnpm add / yarn add / bun add。

### @bjia56/portable-python-3\.12 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @bjia56/portable-python-3\.12 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @bjia56/portable-python-3\.12 可以商用吗？

@bjia56/portable-python-3\.12 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @bjia56/portable-python-3\.12 的下载量有多少？

根据 npm 官方下载统计，@bjia56/portable-python-3\.12 在 2026/10/08 – 2026/11/06 这 30 天内被下载 1,833 次，日均约 61 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bjia56/portable-python-3\.12 还在维护吗？

最新版本 0\.1\.42 发布于 2026/10/30（9 天前）；至今共发布 44 个版本，其中过去 12 个月发布了 2 个；首次发布于 2024/03/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。