如何搭建 Label Studio 开发环境4步从源码到本地热重载【免费下载链接】label-studioLabel Studio is a multi-type data labeling and annotation tool with standardized output format项目地址: https://gitcode.com/GitHub_Trending/la/label-studio你克隆完 Label Studio 仓库后端起来了页面却是白屏前端 8010 也跑着刷新后还是连不上——这是搭这套环境时最典型的现场。Label Studio 是一个多类型数据标注工具支持图片、文本、音频、视频和时间序列前后端分离React 前端用 Vite 跑在 8010 端口Django 后端跑在 8080 端口两边各自装依赖、各自起服务。走完下面四步你就能独立完成 Label Studio 开发环境搭建并且改一行代码立刻在浏览器里看到结果。启动前的准备先确认机器满足最低要求Python 3.10pyproject.toml 要求3.10Bun 运行时前端用它装依赖和起服务Poetry官方 README 推荐的依赖管理方式内存 4GB 以上磁盘 2GB 空闲Linux/macOS 直接跑Windows 建议用 WSL2整体架构一句话web/是 React 前端label_studio/是 Django 后端两者通过本地端口通信开发时各自开一个终端。第一次把项目跑起来 拿代码克隆仓库并进入目录这是后续所有命令的工作根目录git clone https://gitcode.com/GitHub_Trending/la/label-studio cd label-studio成功标志ls能看到label_studio/、web/、Makefile三样东西。装依赖后端依赖用 Poetry 装前端依赖进web/用 Bun 装pip install poetry poetry install # 后端 Python 依赖 make frontend-install # 前端依赖等价于 cd web bun install成功标志两条命令都正常结束、无依赖冲突报错。起服务先做数据库迁移再分别起后端和前端两个终端make migrate-dev # 终端1初始化 SQLite 数据库 make run-dev # 终端1起 Django 后端监听 8080 make frontend-dev # 终端2起 Vite 前端监听 8010成功标志打开 http://localhost:8080 能看到 Label Studio 的登录页面。改一行代码验证热重载 先让 Django 知道要启用热模块替换在项目根目录建一个.env文件cat .env EOF FRONTEND_HMRtrue EOF保存后端服务让配置生效。然后随便找一个渲染文本的前端组件改一行展示文案- div classNamels-titleProjects/div div classNamels-title我的项目/div保存文件浏览器里的页面会自动更新不用重启任何服务。这就是 HMR 在工作的证据。看懂项目目录结构 label-studio/ ├── label_studio/ # Django 后端 │ ├── manage.py # 后端入口 │ ├── core/ # 核心配置与路由 │ └── tasks/ # 任务与标注相关模型 ├── web/ # 前端 monorepo │ ├── apps/labelstudio/ # 主应用 │ └── libs/editor/ # 标注编辑器核心库 ├── docs/ # 官方文档源码 ├── Makefile # 开发命令集合 └── pyproject.toml # Python 依赖声明几个日常会碰到的文件Makefilerun-dev、frontend-dev等命令都在这日常只跟它打交道label_studio/manage.pyDjango 入口手动跑migrate、runserver都用它web/package.json前端脚本定义dev、build、test:unit都在这web/README.md前端环境与 HMR 配置的权威说明常用命令速查 ⚡命令作用make run-dev启动后端开发服务器SQLite 8080 端口make frontend-dev启动前端热重载服务8010 端口make frontend-install安装前端 Bun 依赖make migrate-dev应用数据库迁移make makemigrations-dev改了模型后生成迁移文件make shell-dev进 Django shell调试数据模型make test跑后端单元测试make fmt按分支 diff 格式化代码出了问题对照排查 现象原因解决页面白屏、样式全丢前端没起或.env缺FRONTEND_HMRtrue跑make frontend-dev补上.env再重启后端8080 拒绝连接后端没跑或没做迁移先make migrate-dev再make run-devbun: command not found没装 Bun 运行时先安装 Bun再跑make frontend-install更多报错细节可以翻 官方安装文档 和 故障排除指南。环境跑通后建议接着做三件事打开label_studio/annotation_templates/里的现成模板照着写一份自己的标注配置按 ML 后端文档 接一个模型体验预标注跑一遍make test熟悉测试基线再考虑提自己的第一份贡献。【免费下载链接】label-studioLabel Studio is a multi-type data labeling and annotation tool with standardized output format项目地址: https://gitcode.com/GitHub_Trending/la/label-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
