当前位置：首页 > news >正文

完整标准 Git 新建项目流程（分两种场景：全新本地项目、克隆远程空仓库）

news 2026/7/1 16:45:29

场景一：本地全新项目，推送到 Gitee/GitHub/GitLab

1. 本地创建项目文件夹
# 创建项目目录并进入
mkdir my-project
cd my-project

2. 初始化 Git 仓库（本地生成 .git 版本库，即项目目录下的t隐藏.gi文件夹）
git init

3. 编写项目代码 + 配置 .gitignore（关键）
新建 .gitignore 文件，屏蔽不需要提交的文件：
plaintext
# 示例通用忽略规则
node_modules/
dist/
build/
*.log
.env
.DS_Store
.vscode/
*.class
target/

4. 将文件加入暂存区
# 添加当前目录所有文件
git add .
# 只添加单个文件 git add index.html

5. 提交到本地仓库（必须带清晰注释）
git commit -m "初始化项目，搭建基础目录结构"

6. 远程平台操作（GitHub/Gitee）
(1)网页端登录 → 新建仓库 New repository
(2)仓库名和本地文件夹同名，不要勾选 Initialize with README（本地已有初始化提交）
(3)创建后复制仓库 HTTPS / SSH 地址

7. 本地关联远程仓库
# origin 是远程仓库默认别名
git remote add origin https://gitee.com/xxx/my-project.git
# 验证远程是否绑定成功
git remote -v

8. 推送本地主分支到远程
新版 git 默认分支名 main，老版本是 master
# main 分支推送
git push -u origin main

# 如果是 master 分支
# git push -u origin master
-u 作用：后续直接 git push 无需写分支名

场景二：远程已有空仓库，本地直接克隆（推荐团队新项目）

适合多人协作，不用手动 init
1、网页新建空仓库（可勾选 README、LICENSE）
网页点「新建空仓库」时，服务器后台自动执行了类似：git init
2、本地克隆远程仓库
git clone https://gitee.com/xxx/my-project.git
cd my-project
执行克隆命令后会创建项目文件夹，并在文件夹内部自动生成完整 .git 版本库目录，包含所有远程仓库元数据（分支、提交记录、远程地址、配置等）

3、开发修改文件 → 提交推送
git add .
git commit -m "新增业务功能"
git push