本文为「AI 全栈开发实战」系列教程的基础环境准备模块第一篇系统讲解 Git 的安装配置、核心概念、常用命令与企业级协同流程同时覆盖码云 Gitee、魔搭 ModelScope 场景下的 Git 实操为后续深度模型资产固化、Agent 开发、工程化交付打下坚实的版本控制基础。一、为什么 AI 开发也必须掌握 Git在很多初学者的认知里Git 只是后端、前端程序员的工具但在 AI 项目开发中Git 同样是不可或缺的核心基础设施代码与脚本版本追踪训练脚本、数据处理代码、推理 pipeline 的每一次修改都可以回溯出现效果退化时能快速回退到稳定版本多人协同开发团队成员并行开发不同模型、不同功能模块通过分支与合并机制高效协作模型资产固化配合 ModelScope 等平台通过 Git 提交完成模型权重、配置文件、推理代码的版本化管理实现算力窗口资产固定化工程化交付最终的高性能推理服务、Agent 应用都需要通过 Git 进行代码管理与 CI/CD 流水线对接Git 是一个分布式版本控制系统区别于 SVN 等集中式工具每一个开发者的本地都拥有完整的仓库副本离线也可以正常提交代码联网后再与远程仓库同步可靠性与灵活性大幅提升。二、Git 核心概念前置科普在动手安装之前先理解几个核心概念后续操作会更容易上手。2.1 三大工作区域工作区Working Directory你电脑上能直接看到、正在编辑的文件目录暂存区Stage / Index临时存放即将提交的文件修改是工作区与版本库之间的过渡层版本库RepositoryGit 存放所有版本记录与元数据的地方也就是.git隐藏目录2.2 基础术语提交Commit一次代码快照是 Git 版本管理的最小单位每个提交都有唯一的哈希值标识分支Branch独立的开发线默认主分支为main或master开发新功能时通常新建分支不影响主分支代码远程仓库Remote托管在网络上的仓库比如 Gitee、GitHub、ModelScope 上的代码仓库克隆Clone把远程仓库完整下载到本地推送Push把本地的提交记录同步到远程仓库拉取Pull把远程仓库的最新更新同步到本地三、全平台 Git 安装与初始配置3.1 Windows 系统安装打开 Git 官网下载Git for Windows最新稳定版安装包双击运行安装程序全程保持默认选项即可推荐勾选「Add Git to PATH」默认已勾选安装完成后在开始菜单中找到Git Bash并打开后续所有 Git 命令都在该终端中执行3.2 macOS 系统安装macOS 提供两种主流安装方式按需选择即可方式一Homebrew 一键安装推荐开发者使用如果你的电脑已经安装 Homebrew 包管理器直接打开终端执行命令bash运行brew install git等待命令执行完成即可该方式会自动配置好环境变量。方式二官方安装器安装直接从 Git 官网下载 macOS 版本安装包按照向导一步步点击完成安装适合没有配置 Homebrew 环境的新手。3.3 Linux 系统安装Debian / Ubuntu对于 Debian、Ubuntu 以及基于它们的发行版直接使用系统自带的 apt 包管理器即可快速安装bash运行sudo apt update sudo apt install git如果是 CentOS / RHEL 系列使用 yum 安装bash运行sudo yum install git3.4 验证安装与基础配置安装完成后打开终端执行以下命令输出版本号即代表安装成功bash运行git --version首次使用 Git 必须配置用户名与邮箱这会作为你每一次提交的身份标识bash运行# 配置全局用户名 git config --global user.name 你的用户名 # 配置全局邮箱 git config --global user.email 你的邮箱地址配置完成后可以通过git config --list查看所有配置项确认信息无误即可开始使用。四、Git 核心命令实操从初始化到第一次提交下面以一个完整的流程带你走完本地仓库创建、文件提交、查看历史的全流程。4.1 初始化本地仓库进入你的项目目录执行初始化命令当前目录就会变成 Git 可以管理的仓库bash运行# 进入项目文件夹 cd your-project # 初始化 Git 仓库 git init执行完成后目录下会生成一个隐藏的.git文件夹这就是 Git 的版本库请勿手动修改其中内容。4.2 查看文件状态随时可以使用status命令查看当前工作区的文件状态哪些文件被修改、哪些在暂存区一目了然bash运行git status4.3 将文件添加到暂存区编辑好文件后需要先把修改添加到暂存区bash运行# 添加单个文件 git add 文件名.py # 添加当前目录所有修改的文件 git add .4.4 提交到版本库暂存区的内容确认无误后执行提交操作生成一个永久的版本记录bash运行# -m 后面跟本次提交的说明文字建议写清晰方便后续回溯 git commit -m 完成数据预处理脚本开发4.5 查看提交历史想要查看所有的提交记录使用 log 命令bash运行# 查看完整历史 git log # 简洁版历史一行显示一个提交 git log --oneline五、远程仓库协同码云 Gitee 实操国内开发推荐使用码云 Gitee作为远程仓库托管平台访问速度快稳定性高对应课程中的「码云 gitee」模块。5.1 关联远程仓库在 Gitee 上创建好空仓库后回到本地项目目录执行关联命令bash运行# 添加远程仓库origin 是远程仓库的默认别名 git remote add origin 你的Gitee仓库地址5.2 本地代码推送到远程第一次推送需要指定上游分支后续可以直接简化命令bash运行# 第一次推送主分支 git push -u origin main # 后续推送直接执行 git push5.3 拉取远程更新如果团队其他人提交了代码你需要同步最新内容到本地bash运行git pull origin main5.4 克隆已有仓库如果是接手已有项目直接克隆远程仓库到本地即可bash运行git clone 仓库地址六、魔搭 ModelScope 场景下的 Git 使用对应课程中的「魔搭中使用 git」主题ModelScope 平台的模型仓库原生支持 Git 协议你可以像管理代码一样管理模型资产。在 ModelScope 创建模型仓库后复制仓库地址本地执行git clone命令下载仓库仓库中包含模型配置文件、推理代码、README 等本地修改或新增模型文件、推理脚本后通过git addgit commit提交执行git push同步到 ModelScope 远程仓库完成模型资产的版本固化这也是课程「模块 2 深度模型资产固化实战」的核心基础能力通过 Git 可以精准追踪每一次模型迭代实现算力窗口内的资产固定化。七、分支管理多人协作的核心开发新功能、修复 bug 时强烈建议新建分支避免直接在主分支开发导致代码不稳定。bash运行# 查看当前所有分支 git branch # 新建并切换到新分支 git checkout -b feature-xxx # 切换回主分支 git checkout main # 把功能分支的代码合并到主分支 git merge feature-xxx # 删除已合并的分支 git branch -d feature-xxx八、本模块配套工具速览「基础环境及操作」模块除了 Git还包含多个 AI 开发必备工具后续会陆续更新对应教程码云 Gitee国内代码托管平台远程仓库协同首选魔搭 ModelScopeAI 模型社区与开发平台模型资产托管与训练uv新一代 Python 包管理工具速度远超 pip用于 Python 项目环境管理九、全课程体系导航本系列教程围绕 AI 全栈开发能力搭建完整课程模块如下基础环境准备1.1 基础环境及操作Git / Gitee / 魔搭 /uv1.2 国内 LLM 接入与使用模块 2 深度模型资产固化实战2.1 学习指南2.2 拆解 pipeline2.3 算力窗口资产固定化Agents 智能体开发3.1 LLM API 调用3.2 课程项目目录搭建模块 4 高性能推理与工程化交付4.1 学习指南机器学习的新进展5.1 AutoML 自动化机器学习5.2 前沿研究与讨论十、Git 学习最佳实践建议小步提交不要攒一大堆修改再提交完成一个小功能就提交一次方便后续定位问题写好提交说明清晰的 commit message 是团队协作的基本素养功能分支开发永远不要直接在 main 分支上开发新功能推送前先拉取每次 push 之前先 pull 一下避免冲突多动手实操Git 是工具看十遍不如动手敲一遍命令本文为系列入门第一篇后续会持续更新 Git 进阶操作、冲突解决、魔搭模型提交实战、uv 环境管理等内容。