[Android][Python] SDK 安装 CMake 与 Windows python 无响应排查

[nzcv]

[Android][Python] SDK 安装 CMake 与 Windows python 无响应排查

在 Android SDK 环境通过 cmdline-tools 安装 CMake，并排查终端执行 python / python3 无任何响应的原因与解决方案。

一、使用 sdkmanager 安装 CMake

环境前提

• SDK 根目录：D:\Android\Sdk
• cmdline-tools 路径：D:\Android\Sdk\cmdline-tools\bin\sdkmanager.bat
• sdkmanager 需要 Java（本次使用 Rider 自带 JBR）

常见问题

1. JAVA_HOME 未设置：报错 JAVA_HOME is not set and no 'java' command could be found in your PATH
2. SDK root 无法识别：cmdline-tools 不在标准 cmdline-tools\latest\ 目录时，需显式指定 --sdk_root

安装命令

$env:JAVA_HOME = "C:\Program Files\JetBrains\JetBrains Rider 2026.1.2\jbr"
echo y | D:\Android\Sdk\cmdline-tools\bin\sdkmanager.bat --sdk_root=D:\Android\Sdk "cmake;3.22.1"

查看可用版本

sdkmanager.bat --sdk_root=D:\Android\Sdk --list | findstr cmake

可用版本包括 cmake;3.22.1、cmake;4.1.2 等。

安装结果

• 版本：CMake 3.22.1
• 路径：D:\Android\Sdk\cmake\3.22.1\bin\cmake.exe
• 验证：cmake version 3.22.1-g37088a8-dirty

命令行直接使用可将 D:\Android\Sdk\cmake\3.22.1\bin 加入 PATH；Android Studio / Gradle 通常通过 ANDROID_SDK_ROOT 或 sdk.dir 自动发现。

---

二、终端 python / python3 无响应原因

现象

在终端输入 python 或 python3，没有任何输出，也不报错，像"卡住"或"没反应"。

根本原因

python / python3 命中的是 Windows App Execution Alias（应用执行别名）占位符，不是真正的 Python：

C:\Users\yiluoyang\AppData\Local\Microsoft\WindowsApps\python.exe   (0 字节)
C:\Users\yiluoyang\AppData\Local\Microsoft\WindowsApps\python3.exe  (0 字节)

这些是 Windows 在未安装 Python 时提供的"假命令"，实际会尝试打开 Microsoft Store 引导安装。若商店未弹出或静默失败，终端就表现为无响应。

实际情况：已通过 uv 安装 Python

C:\Users\yiluoyang\.local\bin 中有真实 Python，但命令名是带版本号的：

• python3.13.exe → Python 3.13.13 ✅
• python3.9.exe ✅

没有 python.exe 或 python3.exe。PATH 中 WindowsApps 排在 .local\bin 之后，输入 python/python3 时先命中 0 字节占位符。

命令	实际指向	结果
python	Windows 商店占位符	无响应
python3	Windows 商店占位符	无响应
python3.13	uv 安装的真实 Python	正常
py	未安装 Python Launcher	找不到命令

解决方案

方案 A（最快）：直接使用已有命令

python3.13
# 或
python3.9

方案 B（推荐）：关闭 Windows 假别名

1. 设置 → 应用 → 高级应用设置 → 应用执行别名
2. 关闭 python.exe 和 python3.exe
3. 用 uv 设置默认 Python：

uv python install 3.13 --default

方案 C：从 python.org 安装官方 Python，勾选 "Add Python to PATH"，确保真实路径排在 WindowsApps 前面。

方案 D：用 uv 运行脚本

uv run your_script.py

推荐组合

• Android 原生构建：用 sdkmanager --sdk_root=... "cmake;3.22.1" 安装 CMake，配合 NDK 使用
• 日常 Python 开发：关闭应用执行别名 + uv python install 3.13 --default，或直接用 python3.13

[nzcv]

Set-PSReadLineKeyHandler -Key UpArrow -Function HistorySearchBackward
Set-PSReadLineKeyHandler -Key DownArrow -Function HistorySearchForward