一、环境准备：VS Code 快速安装
1.1 下载安装 VS Code
VS Code 是目前最流行的代码编辑器，安装很简单。
- 打开官网 https://code.visualstudio.com/
- 点击'Download for Mac'，根据你的芯片选择：
- Apple Silicon（M1/M2/M3/M4）选 Apple Silicon 版本
- Intel 芯片选 Intel 版本
- 下载完成后解压 zip 文件，把'Visual Studio Code.app'拖到'应用程序'文件夹
- 首次启动如果提示安全校验，右键 VS Code → 打开 → 确认
1.2 安装汉化插件
可选但强烈推荐：安装中文语言包。打开 VS Code 后，在左侧扩展（Extensions）里搜索'Chinese (Simplified) Language Pack'，安装后重启即可。
二、Git 安装与基础配置
2.1 安装 Git（macOS 推荐方式）
在 Mac 上装 Git 最省心的方式是安装 Xcode Command Line Tools，它会带上 Git 以及常用编译工具。
打开'终端'，执行：
git --version
如果系统弹窗提示安装命令行开发者工具，点'安装'即可。安装完成后再次执行上面的命令，看到类似 git version 2.x.x，就成功了。
这一步装好后，Git 就能用了。
2.2 Git 基础配置
Git 装好后，需要告诉它你是谁。这样每次提交代码时，作者信息才会正确。
在终端（terminal）中把下面两条里的名字、邮箱换成你自己的：
git config --global user.name "你的名字"
git config --global user.email "[email protected]"
验证是否生效：
git config --global --list
三、阿里云效配置全流程
3.1 登录云效平台
阿里云效是阿里云推出的企业级代码管理平台，支持 Git 仓库托管、代码评审、持续集成等功能。
打开浏览器，访问 https://codeup.aliyun.com/，使用阿里云账号登录。首次使用需要完成企业或个人空间的设置。
3.2 创建代码组
登录后进入云效首页，按以下步骤创建代码组：
- 点击左侧导航栏的'代码'或'代码组'
- 点击'新建代码组'按钮
- 填写代码组名称（如
my-project）和描述 - 选择可见性：公开或私有
- 点击'创建'完成
代码组类似于文件夹，可以用来组织多个相关的代码仓库。
3.3 创建代码仓库
代码组创建好后，继续创建代码仓库：
- 进入刚创建的代码组
- 点击'新建仓库'按钮
- 填写仓库名称（如
my-first-repo） - 添加仓库描述
- 选择 .gitignore 模板（如 Python、Node.js 等）
点击'创建仓库'
创建完成后，云效会显示仓库的 HTTPS 克隆地址，形如：
https://codeup.aliyun.com/your-group/my-first-repo.git
3.4 设置 HTTPS 密码
云效使用 HTTPS 克隆时需要单独设置密码，这个密码与你的阿里云账号密码不同。
- 访问 https://account-devops.aliyun.com/settings/httpsPw
- 点击'设置 HTTPS 密码'
- 输入新密码并确认
- 点击'确定'保存
重要提示：记好这个密码，稍后克隆代码时会用到。建议使用密码管理器保存。
四、克隆项目与首次提交
4.1 在 Mac 中新建项目文件夹
Mac 用户有个很方便的技巧：可以直接把文件夹拖到终端里自动获取路径。
- 在 Finder 中创建一个新文件夹，比如在'文档'下创建
Projects文件夹 - 打开'终端'
- 输入
cd（注意 cd 后面有个空格） - 把刚创建的
Projects文件夹直接拖到终端窗口里 - 终端会自动填充路径，按回车确认
这样就进入了项目目录。
4.2 克隆代码仓库
在终端中执行克隆命令（把地址换成你自己的仓库地址）：
git clone https://codeup.aliyun.com/your-group/my-first-repo.git
执行后会提示输入用户名和密码：
- 用户名：输入你的阿里云账号
- 密码：输入刚才在云效设置的 HTTPS 密码
输入完成后代码就会开始克隆。克隆成功后，进入项目目录：
cd my-first-repo
4.3 完成首次提交推送
现在你应该能看到代码了。接下来做一次完整闭环：修改 → 提交 → 推送到云效。
随便改一个文件（比如 README）
或者在终端执行：
git status
git add .
git commit -m "chore: first commit from my mac"
推送到远端（如果当前分支已经有关联，直接执行）：
git push
如果提示没有上游分支，按提示设置一次即可（常见为 main）：
git push -u origin main
回到云效仓库页面刷新，能看到你的提交记录，就说明全链路通了。
4.4 日常协作流程
日常开发时，推荐使用功能分支来隔离工作。标准流程是这样的：
- 拉取最新代码
git pull
- 创建功能分支
git checkout -b feature/my-change
- 提交并推送
git add .
git commit -m "feat: my change"
git push -u origin feature/my-change
