Label-Studio安装后启动失败及虚拟环境激活问题求助

问题概述 #

按照官方文档安装Label-Studio，使用pip install label-studio --user后，包已安装到c:\users\*******\appdata\roaming\python\python311\site-packages，但执行label-studio start提示命令未找到；用python -m label-studio也报错找不到模块。尝试虚拟环境安装时，source env/bin/activate命令在Windows下无法执行，且激活后安装仍无法启动。

核心原因 #

• 脚本路径未加入环境变量：--user安装的可执行脚本会放在C:\Users\<用户名>\AppData\Roaming\Python\Python311\Scripts，若该路径不在系统PATH中，命令行无法找到label-studio命令。
• 模块名拼写错误：Label-Studio的模块实际名称是label_studio（下划线），而非label-studio（连字符），所以python -m label-studio会报错。
• 虚拟环境激活命令错误：Windows系统下没有source命令，这是Linux/macOS的用法，Windows需用对应脚本激活。
• 虚拟环境中误用--user参数：虚拟环境里加--user会把包装到用户目录，而非虚拟环境内部，导致虚拟环境的Python找不到包。

解决方案 #

方案1：修复用户级安装的环境变量 #

1. 找到你的Python脚本路径：C:\Users\<你的用户名>\AppData\Roaming\Python\Python311\Scripts
2. 将该路径添加到系统的PATH环境变量中
3. 重启命令行窗口，执行label-studio start即可
4. 或者不用改环境变量，直接执行正确的模块命令：

python -m label_studio

方案2：用虚拟环境正确安装（推荐） #

1. 创建虚拟环境：

python -m venv env

2. 激活虚拟环境：
   • 若用CMD：

   env\Scripts\activate.bat
   

   • 若用PowerShell：

   .\env\Scripts\Activate.ps1
   

3. 安装Label-Studio（不要加--user）：

pip install label-studio

4. 启动Label-Studio：

label-studio start

内容的提问来源于stack exchange，提问作者Gregory