升级 Label Studio
升级Label Studio时，请注意以下事项：
- 备份您的数据: 在开始升级之前，请确保备份您现有的项目、数据库以及任何自定义配置。
- 查看版本发布说明: 查阅发布说明了解您要升级到的版本。注意任何可能需要执行的重大变更或迁移步骤。
- Python兼容性: 确保您的Python版本与新发布的Label Studio兼容。Label Studio支持Python 3.9至3.13版本。使用不兼容的Python版本可能导致安装错误。
- 检查依赖问题: 升级后，请确认所有依赖项已正确安装。如果遇到缺失包错误，可能需要手动安装这些包。在干净的Python环境或虚拟环境中运行Label Studio可以降低包冲突的可能性。
- 测试您的设置: 升级后，请测试您的Label Studio实例以确保一切按预期工作。检查关键功能，如任务加载、标注界面、数据导出以及您使用的任何集成。
- 排查安装问题: 如果在升级过程中遇到任何问题，请参阅Troubleshoot installation issues。
使用pip升级
pip install --upgrade label-studio使用Docker升级
停止现有的Label Studio容器:
docker ps # 查找容器ID或名称 docker stop拉取最新的Label Studio Docker镜像：
docker pull heartexlabs/label-studio:latest使用最新镜像启动一个新容器，保持与之前相同的卷映射：
docker run -it -p 8080:8080 \ -v /path/to/yourdata:/label-studio/data \ -v /path/to/yourfiles:/label-studio/files \ heartexlabs/label-studio:latest将
/path/to/yourdata和/path/to/yourfiles替换为您之前使用的实际路径。运行数据库迁移（如有必要）。
如果在升级后遇到任何问题，可能需要执行数据库迁移：
docker exec -itbash cd /label-studio python manage.py migrate 在浏览器中打开Label Studio，访问
http://localhost:8080，检查您的项目和数据是否可访问。
从源码安装后升级
如果您通过Github源码安装了Label Studio，可以按照以下步骤进行升级。
如果您正在使用Poetry（参见这些说明），请按照以下步骤进行升级：
- 导航到您的Label Studio目录（您克隆代码库的位置）。
- 从代码仓库获取最新变更:
git pull - 如需升级到特定版本，请列出可用标签并检出所需版本。例如，升级到1.14.0版本：
git fetch --tags git checkout v1.14.0 - 使用Poetry安装更新的依赖项：
poetry install - 运行数据库迁移以应用对数据库模式的任何更新：
poetry run python label_studio/manage.py migrate - 收集静态文件:
poetry run python label_studio/manage.py collectstatic - 重启Label Studio:
poetry run python label_studio/manage.py runserver
- 导航到您的Label Studio目录（您克隆代码库的位置）。
- 从代码仓库获取最新变更:
git pull - 如需升级到特定版本，请列出可用标签并检出所需版本。例如，升级到1.14.0版本：
git fetch --tags git checkout v1.14.0 - 安装更新的依赖项:
pip install -r requirements.txt - 运行数据库迁移以应用对数据库架构的任何更新：
python label_studio/manage.py migrate - 收集静态文件:
python label_studio/manage.py collectstatic - 重启Label Studio:
python label_studio/manage.py runserver