技术文献

初始化Git并推送项目

2026-10-31

已经在 GitHub 上创建好了远程仓库:

https://github.com/jetzuomaolian/Ubuntu-apache-generate.git

第一步:进入项目根目录
例如你的项目目录是:
cd /var/www/Ubuntu-apache-generate

第二步:初始化 Git
git init

执行成功后,会在项目目录下生成隐藏目录:
.git/

第三步:配置 Git 用户信息
如果这台服务器或电脑以前没有配置过 Git,需要执行:
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub邮箱"

第四步:创建 .gitignore 文件
建议在项目根目录创建:
nano .gitignore

如果这是一个 PHP 项目,可以先使用下面的内容:
# OS files
.DS_Store
Thumbs.db

# IDE
.idea/
.vscode/

# Logs
*.log
logs/

# Temporary files
*.tmp
*.bak

# Environment configuration
.env
.env.local

# Dependencies
vendor/
node_modules/

第五步:添加项目文件
先检查一下哪些文件会被提交:
git status
然后添加所有文件:
git add .
再检查一次:
git status
确认没有把密码、数据库配置、API Key、证书私钥等敏感文件加入提交。

第六步:创建第一次提交
git commit -m "Initial commit"

第七步:关联 GitHub 远程仓库
执行:
git remote add origin https://github.com/jetzuomaolian/Ubuntu-apache-generate.git

检查是否关联成功:
git remote -v

第八步:Push 到 GitHub
先确保本地分支名称为 main:
git branch -M main

然后执行:
git push -u origin main

 

以后修改代码,如何再次 Push?
第一次初始化完成后,以后只需要执行三个命令:
git add .

git commit -m "Update project"

git push


完整命令汇总
如果你想一次性执行,可以使用下面的命令(前提是已经创建好 .gitignore):
# 1. 初始化
git init -b main

# 2. 添加文件
git add .

# 3. 第一次提交
git commit -m "Initial commit"

# 4. 关联远程仓库
git remote add origin https://github.com/jetzuomaolian/Ubuntu-apache-generate.git

# 5. 推送
git push -u origin main


解释:

git init -b main 的作用是:初始化一个新的 Git 仓库,并且将默认分支名称设置为 main。

它实际上包含两个部分:

初始化 Git 仓库。
git init


执行后,会在当前项目目录生成 .git 隐藏目录。
2. -b main
指定初始分支名称为 main。
git init -b main


其中:
- -b:指定初始分支(branch)。
- main:分支名称。
两种写法有什么区别?
命令    作用
git init    初始化仓库,使用 Git 默认分支名称
git init -b main    初始化仓库,明确指定分支为 main

例如,执行:
git init -b main


然后查看当前分支:
git branch


输出:
* main


为什么推荐使用 main?
以前 GitHub 默认使用 master 作为主分支名称,现在通常使用 main。

因此,我建议你以后新建项目统一使用:
git init -b main


这样本地分支和 GitHub 远程仓库的主分支名称保持一致,就不需要额外修改分支名称了。