本地文件创建git仓库并提交到Github

63 阅读2分钟

以下是将本地代码文件夹创建为 Git 仓库并同步到 GitHub 的全过程步骤:

前提条件

  • 确保在本地已安装 Git
  • 已注册 GitHub 账号,并且在 GitHub 上创建了一个新的仓库(可以是空仓库)。

步骤 1:在本地初始化 Git 仓库

  1. 打开终端或命令行,进入项目所在的目录:

    cd /path/to/your/local/project
    
  2. 初始化 Git 仓库

    git init
    

    这将创建一个隐藏的 .git 文件夹,Git 会用它来管理项目的版本控制。

步骤 2:添加文件到 Git 仓库

  1. 查看当前文件状态

    git status
    

    这将显示所有未被跟踪的文件。

  2. 将文件添加到 Git 暂存区

    git add .
    

    . 表示将所有文件添加到暂存区。你也可以用 git add filename 来添加特定文件。

  3. 提交文件

    git commit -m "Initial commit"
    

    -m 用于提供简短的提交信息,例如 "Initial commit"

步骤 3:创建远程仓库

  1. 在 GitHub 上创建一个新的仓库

    • 进入 GitHub
    • 点击右上角的 + 图标,选择 “New repository”。
    • 输入仓库名称和其他选项。
    • 注意:保持仓库为空,不要添加 README.md.gitignore 文件。
  2. 复制仓库的 HTTPS 或 SSH 链接

    例如,HTTPS 链接类似于:

    https://github.com/username/repository.git
    

步骤 4:将本地仓库与 GitHub 仓库关联

  1. 添加远程仓库地址

    git remote add origin https://github.com/username/repository.git
    

    https://github.com/username/repository.git 替换为你的 GitHub 仓库链接。

  2. 验证远程仓库

    git remote -v
    

    输出应包含 origin 的远程地址,说明关联成功。

步骤 5:推送本地仓库到 GitHub

  1. 设置默认分支

    git branch -M main 
    
  2. 推送代码到 GitHub 仓库

    git push -u origin main
    
    • -u 表示将本地的 main 分支与远程的 origin 仓库关联。
    • origin 是远程仓库的名称(默认名称为 origin)。
    • main 是推送的分支名称。可以用 git branch 检查分支名称。

    注意:第一次推送时可能会提示输入 GitHub 的用户名和密码。

步骤 6:验证推送结果

  1. 登录 GitHub 并进入仓库,刷新页面,查看是否成功上传了本地代码。

  2. 确认代码已成功上传,包含初始提交的信息和文件结构。


补充说明

  • 定期提交和推送:在开发过程中,可以通过以下命令定期提交更改:

    git add .
    git commit -m "Your commit message"
    git push
    
  • 生成 SSH 密钥:如果不想每次推送代码时输入用户名和密码,可以使用 SSH 方式。首先生成 SSH 密钥并添加到 GitHub:

    ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
    

    然后将生成的公钥(~/.ssh/id_rsa.pub)添加到 GitHub 的 SSH Keys 中。