创建 GitHub 仓库
a. 登录到您的 GitHub 账户。
b. 点击右上角的 "+" 图标,选择 "New repository"。
c. 填写仓库名称(例如 "Mitemer")。
d. 添加项目描述(可选)。
e. 选择仓库为 "Public"(如果您希望它是开源的)。
f. 不要初始化仓库,因为我们会上传现有文件。
g. 点击 "Create repository"。
仓库页面简单介绍
注意:如果使用官方的推送方式行不通,就使用我推送的方式
这个页面展示了一个新创建的 GitHub 仓库 "Mitemer" 的初始设置界面。
- GitHub Copilot 设置: 提供了设置 GitHub 的 AI 辅助编码工具 Copilot 的选项。
- 添加协作者: 允许你通过 GitHub 用户名或邮箱地址邀请其他人参与这个项目。
- 快速设置选项:
- 提供了在桌面端设置仓库的选项
- 显示了 HTTPS 和 SSH 的仓库 URL
- 建议创建 README、LICENSE 和 .gitignore 文件
- 命令行创建新仓库: 提供了一系列 Git 命令,用于在本地创建仓库并推送到 GitHub。
- 推送现有仓库: 如果你已经有一个本地仓库,这里提供了将其推送到这个新的 GitHub 仓库的命令。
README、LICENSE 和 .gitignore 文件
这三个文件共同构成了一个完善的 GitHub 项目的基础:README 介绍项目,LICENSE 定义使用条款,.gitignore 管理版本控制范围。它们一起确保你的项目专业、规范,并且易于他人理解和参与。
当然,我很乐意为您介绍这三个重要的文件:
README 文件
- 通常命名为 README.md(使用 Markdown 格式)
- 这是项目的门面,通常是人们访问你的 GitHub 仓库时首先看到的文件
- 主要用途:
- 简要介绍项目的目的和功能
- 提供项目的安装和使用说明
- 列出主要特性和功能
- 说明如何贡献到项目
- 提供联系信息和相关链接
- 好的 README 文件可以吸引更多的用户和贡献者
LICENSE 文件
- 定义了其他人可以如何使用、修改和分发你的项目
- 主要类型:
- 开源许可证(如 MIT, Apache, GPL)
- 专有许可证
- 公共领域声明
- 重要性:
- 保护你的知识产权
- 明确规定他人使用你的代码的权利和限制
- 对于开源项目来说尤其重要,因为它定义了协作的法律框架
.gitignore 文件
- 告诉 Git 哪些文件或目录应该被忽略,不纳入版本控制
- 主要用途:
- 排除编译生成的文件(如 .class, .o)
- 忽略包含敏感信息的配置文件(如包含密码的配置文件)
- 排除依赖目录(如 node_modules)
- 忽略操作系统生成的文件(如 .DS_Store)
- 好处:
- 保持仓库干净,只包含真正需要版本控制的文件
- 提高 Git 操作的效率
- 防止敏感或不必要的信息被意外提交
提交代码流程
这里默认你已经配置好了git,没有配置好后面的步骤就做不了了
配置用户名,和邮箱
git config --global user.email "you@example.com"
git config --global user.name "Your Name"
初始化本地 Git 仓库 打开命令行(终端),导航到您的项目文件夹:(必须在你的项目文件目录下打开)
后续的命令是最常用的命令了
git init:它会创建一个名为 .git 的隐藏目录,用于存储所有的 Git 相关信息。
git add .:(注意有个句号)这个命令用于将当前目录下的所有文件和子目录添加到 Git 的暂存区
git commit -m "提交内容信息":这个命令用于创建一个新的提交(commit)。
git init
git add .
git commit -m "Initial commit: Add README files"
git push:将本地的提交(commits)上传到远程仓库。main:为指定分支,可以不写
git push https://github.com/you_repo/Mitemer.git main
git pull:从远程仓库获取最新的更改并合并到你的本地分支。
git pull https://github.com/you_repo/Mitemer.git main
后续的代码流程按这个循环走