X‑AnyLabeling（CPU版）完整安装\&使用手册

环境：Miniconda3，虚拟环境名：x-anylabeling‑cpu，Python版本：3.12

⚠️重要：不要用base环境（python3.14），会版本报错，全程使用【Miniconda Prompt】终端，不要用普通cmd/PowerShell

📦一、完整安装全过程（你本次已经做完，留作存档）

1. 打开Windows开始菜单，启动 Miniconda Prompt（进入(base)基础环境）

2. 接受Anaconda服务条款（解决TOS报错）

conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/main
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/r
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/msys2

3. 创建python3.12的CPU虚拟环境

conda create --name x-anylabeling-cpu python=3.12 -y

4. 激活刚创建的虚拟环境

conda activate x-anylabeling-cpu

✅提示符前面变为 (x-anylabeling‑cpu)，代表激活成功，后续所有命令都要在此环境运行

5. 安装uv高速pip工具

pip install -U uv

6. 使用清华源安装X‑AnyLabeling CPU版本

uv pip install "x-anylabeling-cvhub[cpu]" --index-url https://pypi.tuna.tsinghua.edu.cn/simple

7. 启动程序，自动打开浏览器网页标注界面

x-anylabeling

🚀二、后续每次启动软件固定流程（关机重启后必须照这个来！）

⚠️注意：软件没有桌面快捷方式，必须走终端启动，黑色窗口不能关闭，关闭程序就退出

1. 打开开始菜单，运行 Miniconda Prompt

2. 激活标注工具专属环境（必执行，忘记就会报找不到命令）

conda activate x-anylabeling-cpu

3. 启动X‑AnyLabeling

xanylabeling

4. 等待片刻，浏览器自动弹出网页标注界面，直接使用。

✂️退出软件

1. 关掉浏览器标签页

2. 回到黑色Miniconda Prompt窗口，按 Ctrl+C终止程序，关闭窗口即可。

🛠三、常用辅助命令备查

1.查看本机所有conda虚拟环境

conda env list

2.如果以后想删除这个环境（重装才用）

conda remove -n x-anylabeling-cpu --all -y

3.更新x‑anylabeling到最新版本（激活环境后执行）

uv pip install -U "x-anylabeling-cvhub[cpu]" --index-url https://pypi.tuna.tsinghua.edu.cn/simple

⚠️四、高频踩坑清单

1. 报错x-anylabeling不是内部或外部命令：没有执行conda activate x-anylabeling-cpu，关闭终端重新打开完整走一遍启动流程。

2. 版本报错：不要在(base)环境运行，base是python3.14，该工具不支持。

3. 第一次打开网页加载很慢：程序在后台下载AI模型，耐心等待，不要关闭终端。

4. 黑色终端窗口千万不要最小化关掉，关掉网页还在，但是工具已经停止工作。