STAGE 02-2 · 跑起来
团队分支创建规范
环境搭好之后，下一步是在正确的位置建分支。团队统一通过 GitLab 网页端创建分支，分支名从飞书文档获取。
01 / 获取分支名
从飞书文档获取当前迭代的分支名
每个迭代的分支名都不一样，需要从飞书文档中查找。
打开飞书文档 迭代分支表 ↗，找到当前迭代对应的代码分支。
分支名格式示例：263.0.2.1/feat/alarm，其中包含迭代版本号和功能描述。
02 / 命名规范
分支与提交的命名规范
团队对分支名、commit 信息有统一约定，动手前先过一遍。
完整的命名规范见飞书文档 Git 分支提交规范 ↗，点开查看最新约定。
03 / 创建分支
在 GitLab 网页端创建分支
团队统一在 GitLab 网页端操作，不使用命令行。
进入 Novoone-Front 项目页面，点击 New branch，填写两项信息：
263.0.2.1/feat/alarmmaster最新代码由前端统一合并到 master04 / 创建之后
通知前端同事创建路由
分支建好不算完，还需要前端同事配置路由后才能在本地访问。
分支创建完成后，通知对应的前端开发同事，请他们在代码中添加路由配置。路由配置好之后，才能在本地开发服务器上看到新页面。
263.0.2.1/feat/alarm
git pull 拉取路由配置，继续后续工作
05 / 本地切换分支
在终端里切到新分支
GitLab 上建好分支后，本地还不知道它的存在——需要先同步再切换。
4.1 打开终端，进入项目目录
cd ~/Projects/项目文件夹4.2 拉取远程最新的分支信息（不会改任何文件，只是同步"远程有哪些分支"）
git fetch4.3 切换到新分支
git switch 263.0.2.1/feat/alarm4.4 确认当前所在分支（前面带 * 号的就是当前分支）
git branch06 / 拉取路由配置
前端加好路由后，拉取到本地
路由配置在代码里，需要 pull 下来才能在本地访问新页面。
前端同事创建好路由并推送到分支后，在终端执行：
git pull这样本地就拿到了最新的路由配置。
07 / 启动开发服务器
把项目跑起来
最后一步：启动开发服务器，在浏览器里看到页面。
pnpm dev终端会输出本地地址（通常 localhost:3000），浏览器打开即可。改完代码保存后会自动刷新；按 Ctrl + C 停止服务器。（启动细节见 02-1。）
常见问题
踩坑 Q&A
cd 命令报 "no such file or directory"
常见原因：1) cd 和路径之间没有空格；2) 使用了中文全角符号 ～ 而不是英文半角 ~；3) ~ 本身就代表 Home 目录，不要和完整路径拼在一起。正确写法：cd ~/Projects/项目文件夹 或 cd /Users/用户名/Projects/项目文件夹。
git fetch 报 "not a git repository"
说明当前终端不在项目目录里。先 cd 进入项目文件夹（能看到 .git 隐藏文件夹的那个目录），再跑 git 命令。
git fetch 时出现 SSH WARNING（post-quantum）
这是 OpenSSH 新版本的安全提示，不是报错。意思是连接没有使用后量子加密算法。可以忽略，不影响任何操作，几乎所有 GitLab 服务器都会触发。
不知道当前在哪个分支
运行 git branch，前面带 * 号的就是当前分支。
本课核心