我现在在哪个文件夹
pwd缩写自 print working directory。打印当前所在的目录路径，迷路时先敲它。
STAGE 00 · 开始之前
新人冷启动：从零把项目跑起来
后面所有课都默认你已经"装好了工具、配好了账号"。这一课就来补上这段——从一台全新电脑，到能在浏览器里看到项目页面。
01 / 先认识终端
终端就是"用打字代替点鼠标"
后面很多操作在终端里完成，先把它的基本用法搞清楚。
终端（Terminal）是一个能直接给电脑下达文字指令的窗口。平时点图标、拖文件，在这里换成"敲一行命令、回车执行"。macOS 按 Command + 空格 搜 "Terminal" 回车即可打开。
开始之前，先记住两件事，能帮你避开一大半新手的坑：
一、行首的提示符不用你打。每行开头那段系统自动显示的字（新版 macOS 是 %，老系统是 $），比如 yeastar@Finn ~ %，是在告诉你"该你输入了"。你只敲它后面的内容就行。本教程为了通用会把命令写成 $ pwd，你只敲 pwd。
二、命令就是那个短短的缩写本身。下面每条命令旁边的英文（如 print working directory）只是帮你记忆这个缩写怎么来的，不要把整句英文打进去。
这个文件夹里有什么
ls缩写自 list。列出当前目录下的文件和文件夹。不确定能进哪个时，先用它看一眼。
进入某个文件夹
cd 文件夹名缩写自 change directory，后面跟一个空格再跟文件夹名。cd ~ 回主目录，cd .. 退回上一层。
"没反应"通常是成功了
终端有个让新手很懵的特点：很多命令成功时是"安静的"，什么都不打印。比如 cd .. 按完没任何提示，不是没反应——它已经把你移到上一层了，只是不吭声。
想确认它动没动，看行首提示符末尾的那个词，那就是你当前所在的文件夹名：从 ...skills % 变成 ...Desktop %，就说明生效了。cd 这类是"安静型"，靠提示符确认；pwd、ls 是"出声型"，一定会把结果打印出来。所以"没反应"十有八九是成功了——真出错时，终端一定会红字报给你看。
真实踩坑速查表
下面都是新手第一次上手时真实踩到的坑，对照症状一眼定位。
你看到的报错 / 现象原因正确做法
command not found: $把行首提示符 $/% 也打进去了只敲提示符后面的内容敲
print working directory 回显了文字把命令旁的英文全称整句打了进去命令是缩写本身，只敲 pwdcommand not found: cd..cd 和 .. 之间漏了空格写 cd ..，中间留一个空格permission denied: /Users/.../branding直接打路径，被当成"运行文件夹"前面加 cd ：cd /Users/.../brandingno such file or directory: skills当前文件夹里没有这个子文件夹先 ls 看有什么，再 cd 进去cd .. 按完"没反应"不是没反应，cd 是安静型命令看提示符或敲 pwd 确认一条总规律：命令和它后面的内容之间，一律用空格隔开。想明白这条，上面一半的坑都不会再踩。
02 / 装工具
装好这 4 样工具
先把后面所有课都要用到的基础工具装齐，每样配一行命令验证是否装好。
Git — 本地版本管理工具，记录文件改动、管分支。macOS 上第一次运行 git 会提示安装命令行工具，按提示装即可；也可从官网安装。
git --version # 能打印版本号就说明装好了，例如 git version 2.50.1如果没打印版本号，而是报错怎么办？分两种情况，对照你看到的提示处理——
情况 A：弹出一个安装窗口，提示"要使用命令行工具 git，需要安装开发者工具"。这是 macOS 自带的引导，直接点「安装」(Install) 等它装完即可，不用去任何网站。也可以主动触发这个窗口：
xcode-select --install情况 B：报 command not found: git，说明系统里完全没有 git。推荐用 Homebrew（mac 上的"软件管家"）安装。先装 Homebrew（参考 brew.sh 首页那条命令），装完重开终端，再运行：
brew install git两种方式装完后，重开终端再敲一次 git --version，能打印版本号就成功了。Windows 电脑则到 git-scm.com/downloads 下载安装包，一路下一步即可。
Node.js + pnpm — 跑前端项目的运行环境和包管理器。Node.js 让项目能跑起来，pnpm 负责下载项目依赖。中间还推荐装一个 nvm：它是"Node 版本管理器"，因为不同项目可能要求不同 Node 版本，有了 nvm 就能随时切换。我们项目里有个 .nvmrc 写明版本，进项目敲 nvm use 就自动切到团队统一版本。所以顺序是：装 nvm → 用 nvm 装 Node → 用 npm 装 pnpm。
# 1. 安装 nvm（参考官网，装完需重开终端）
# https://github.com/nvm-sh/nvm
# 2. 用 nvm 安装并启用 Node（项目若有 .nvmrc，进项目后 nvm use 即可）
nvm install --lts
node -v # 打印 Node 版本
# 3. 安装 pnpm 包管理器
npm install -g pnpm
pnpm -v # 打印 pnpm 版本上面链接是 GitHub，但它只是 nvm 这个开源工具的下载点，和"我们用 GitLab 还是 GitHub"无关——团队的业务代码始终在公司 GitLab。
VS Code — 改代码、改文案用的编辑器。被要求"改个文案"时，就用它打开项目文件夹来改。官网下载：code.visualstudio.com。
Claude Code — 团队 AI 协作的核心工具，02-1 的"三步收尾"和 03-1 的模板都依赖它。安装与登录见 官方文档。
装完每样工具都重开一次终端，新命令才会生效——很多 "command not found" 都是因为没重启终端。
03 / 配置 Git 身份
给本地 Git 配上你的名字和邮箱
这一步和你用 GitHub 还是 GitLab 无关，是本地 Git 自己要用的，跑不掉。
每次你 git commit，Git 都会在这条提交上盖一个章："这次修改是谁、什么时候做的"。这个"谁"，就是从下面这份配置读出来的。这一步发生在你自己电脑上、在代码碰到 GitLab 之前就完成了。
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
git config --global --list # 确认配置已生效和 GitLab 的账号有什么关系？GitLab 账号是"进办公楼的门禁卡"（能不能进、能改哪些项目）；
git config 的名字邮箱是"在文件上签的名"（这次改动署谁的名）。两件事不替代——不配的话新版 Git 会拒绝提交，报 Author identity unknown。邮箱建议和 GitLab 账号一致，这样提交才会关联到你的账号和头像。04 / 连上公司 GitLab
账号、权限与认证
先开账号、拿项目权限，再配好认证，才能把项目下载到本地。
1. 账号与权限：公司 GitLab 地址是 https://gitlab.yeastar.com/。账号开通、以及 Novoone-Front 等项目的访问权限，找 Finn 申请即可。
2. 配置认证（SSH 方式）：账号有了之后，还要让你的电脑能通过 GitLab 的身份验证，才能 clone 代码。团队用的是 SSH key。
SSH key 是什么？可以理解成一对配套的"钥匙和锁"：你电脑上生成一把私钥（自己保管，绝不外发）和一把公钥（
.pub 结尾，贴到 GitLab 上）。配好后，每次 clone / push，GitLab 用公钥验证你的私钥，对得上就放行——不用每次输密码。第 1 步：先看自己有没有配过 key
ls ~/.ssh如果列出来有 id_ed25519.pub 或 id_rsa.pub 这类 .pub 文件，说明你已经有 key 了，直接跳到第 3 步。如果报 "No such file or directory" 或列表里没有 .pub 文件，就做第 2 步生成。
第 2 步：生成一对新的 key（把邮箱换成你的 GitLab 邮箱）
ssh-keygen -t ed25519 -C "你的GitLab邮箱"回车后会问保存路径和密码，一路直接回车用默认值即可（密码可留空）。完成后就在 ~/.ssh/ 下生成了 id_ed25519（私钥）和 id_ed25519.pub（公钥）。
第 3 步：复制公钥内容，贴到 GitLab
pbcopy < ~/.ssh/id_ed25519.pub # 把公钥内容复制到剪贴板（macOS）然后打开 gitlab.yeastar.com → 设置 → SSH Keys，点 "Add new key"，把刚复制的内容粘进 Key 输入框，保存。注意：贴的是公钥（.pub），私钥永远不要外发。
第 4 步：验证连接
ssh -T git@gitlab.yeastar.com你看到的含义
Welcome to GitLab, @你的用户名!✅ 配好了，认证正常首次问
Are you sure... (yes/no)?正常，输 yes 回车确认一行 post-quantum WARNING忽略它，是提示不是错误
Permission denied (publickey)❌ 公钥没贴好，回到第 3 步重做关于那行 WARNING：验证时大概率会蹦出 "connection is not using a post-quantum key exchange algorithm"。这只是 OpenSSH 新版的安全提示，不影响任何操作，几乎每台连 gitlab.yeastar.com 的电脑都会触发，直接忽略。只要后面跟着
Welcome to GitLab 就说明成功了。认证打通后，你才能 git clone 把项目下载到本地。这是整个冷启动里最容易卡住的一步，配好之后后面就顺了。
05 / 第一天上手清单
把上面这些串成一条直线
工具装齐、认证配好之后，从拿到项目到看见页面，就是这五步。
clone 项目→cd 进目录→pnpm install→pnpm dev→浏览器打开
git clone <项目地址> # 下载项目到本地（地址见上一节）
cd <项目文件夹> # 进入项目目录
pnpm install # 安装依赖（第一次必做）
pnpm dev # 启动开发服务器
# 终端会输出本地地址（通常 localhost:3000），浏览器打开即可这条主线后面 02-1、02-2 会展开讲细节。这里先有个完整印象：装齐工具 → 配好认证 → clone → install → dev。
06 / 常见冷启动报错
第一次最容易遇到的几个坑
对照症状快速定位，大多是环境没配齐导致的。
git clone 报 Permission denied
认证没配好。如果团队用 SSH，多半是 SSH key 没生成或没贴到 GitLab；如果用 HTTPS，多半是 Access Token 不对。回到第 04 节按团队方式重配。
pnpm: command not found
pnpm 没装，或装好后终端没重开。先 npm install -g pnpm，然后关掉终端重新打开再试。
pnpm install 失败 / 报 Node 版本不对
Node 版本和项目要求不一致。进项目目录后跑 nvm use（项目带 .nvmrc 时会自动切到指定版本），再重新 install。
Author identity unknown（提交时报错）
还没配 Git 身份。回到第 03 节跑 git config --global user.name/user.email。
本课核心