我也用github(2)——关联本地工程到github

本文详细介绍如何在GitHub上创建仓库并将本地工程同步至该仓库。包括仓库初始化、文件添加、提交及推送等步骤,并提供了SSH格式地址配置教程。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

github只是为我们提供了一个存储的功能,我们也可以准备一个服务器(当然,能联网是前提了),将版本库保存到服务器上。

本文以github为例进行实验。


1. 在github上创建一个仓库

这个非常简单,参考http://blog.youkuaiyun.com/xiahouzuoxin/article/details/9393119

本文创建后的仓库HTTP格式地址为:https://github.com/xiahouzuoxin/mp3-edcode.git

本文创建后的仓库SSH格式地址为:git@github.com:xiahouzuoxin/mp3-edcode.git

本文使用SSH格式地址,创建仓库后的地址先记住:一般是git@github.com:[user-name]/[repository-name].git格式。


2. 推送本地工程到github仓库

进入到本地工程目录。依次执行:

git init                   # 本地仓库初始化,执行完后会在工程目录下生成一个.git的隐藏目录

git add .               # 添加所有文件到本地索引,命令用法:git add <file>

git commit -m "My first commit operation"   # 提交修改到本地仓库,-m选项添加提交注释

git remote add origin git@github.com:xiahouzuoxin/mp3-encode.git   # 添加远程仓库地址,保存在origin变量中

git push origin master      # 按照前一条命令中origin给定的github地址推送到github仓库的master分支


Notes:

(1)在git commit时可以为本次提交添加注释,注释将在使用git log查看提交日志时可以看见,这有助于分辨不同提交的更改。

commit注释最好以一行短句子作为开头,来简要描述一下这次commit所作的修改(最好不要超过50个字符);然后空一行再把详细的注释写清楚。这样就可以很方便的用工具把commit释变成email通知,第一行作为标题,剩下的部分就作email的正文。

(2)要习惯在工程中使用README文件,文件名可以是README.txt或README.md,README的信息能被github自动识别并显示在项目主页。

README要简明扼要地描述:项目的目的,已有的功能,源代码的结构及使用,参考文献/资料。

README.md文件的语法格式参见https://github.com/guoyunsky/Markdown-Chinese-Demo

(3)LINENSE信息

这个看大家的喜好了,喜欢开源的筒子们喜欢整一个。

(4)忽略一些文件,不提交的方法

在仓库根目录下创建名称为“.gitignore”的文件,写入不需要的文件夹名或文件,每个元素占一行即可,如

Debug

Release


附录(常用命令)

Local:

git clone git@github.com:xiahouzuoxin/mp3-encode.git        # 在本地克隆一个github上仓库

git status                    # 获得当前项目的一个状况

git commit -a              # 将修改文件(不包括新创建的文件)添加到索引,并提交到仓库

git add [file]                # 添加文件到本地索引

git branch                  # 获得当前仓库中所有分支列表

git branch zx-branch                # 新建本地一个名为zx-branch的分支,主分支名为master

git branch -D branch_name     # 删除名称为branch-name的本地分支

git checkout master                  # 切回主分支,切换到zx-branch只需要将master改成zx-branch

git log                                        # 查看提交日志,有许多附加参数

    git log -p                               # 显示补丁

    git log --stat                          # 日志统计:那些文件修改了,修改了多少行内容

    git log --graph                       # 使日志看上去更漂亮

git diff master..zx-branch           # 比较两个分支之间差异

git remote rm origin                   #  删除origin变量地址


git branch [name]                 # 创建本地分支,注意新分支创建后不会自动切换为当前分支

git checkout [name]              # 切换到name分支

git checkout -b [name]          # 创建name分支并切换到name分支


git merge [name]                  # 将name分支与当前分支合并,name可以是远程分支,如origin/master


Remote:

git push origin [name]          # 创建远程name分支

git push origin:zx-branch      # 删除远程origin仓库地址的zx-branch分支 

git branch -r                         # 获得当前仓库中所有分支列表,即查看远程分支


注:附录所注命令将根据自己使用体会持续更新。


Refrences:

[1] Git Community Book 中文版,http://gitbook.liuhui998.com

[2] GotGithub: http://www.worldhello.net/gotgithub/index.html

[3] 廖雪峰Git教程:http://www.liaoxuefeng.com

### 如何将本地文件夹推送到 GitHub 要将本地文件夹中的内容上传到 GitHub 的远程仓库,可以通过 Git 工具完成这一过程。以下是具体的操作方法: #### 1. 初始化本地目录为 Git 可管理的仓库 在目标文件夹下打开终端或命令提示符窗口,运行以下命令将其初始化为一个 Git 仓库: ```bash git init ``` 此命令会创建一个新的 `.git` 文件夹,用于跟踪版本控制信息[^4]。 #### 2. 添加文件到暂存区 通过 `git add` 命令将所有文件添加到暂存区(Staging Area)。如果希望一次性添加当前目录下的所有文件,可执行以下命令: ```bash git add . ``` 这里`.`表示当前工作目录下的所有文件都会被加入暂存区。 #### 3. 提交更改到本地仓库 使用 `git commit` 条目记录本次修改并附带一条描述性的消息以便日后查阅: ```bash git commit -m "Initial commit of my project files" ``` 上述 `-m` 参数后的字符串即为提交说明文字。 #### 4. 关联远程仓库 假如已经预先建立好了一个空的远程仓库,则需指定其 URL 地址作为本地副本的目标位置;例如: ```bash git remote add origin https://github.com/username/repository-name.git ``` 这里的 `origin` 是默认名称代表远端服务器连接路径,而后面的链接应替换为你实际拥有的私有或者公开存储库URL^。 #### 5. 推送数据至远程主机 最后一步就是正式发送这些改动给云端服务提供商——也就是我们的GitHub账户下了: 对于大多数情况来说, 主分支的名字应该是main而不是旧式的master所以推荐这样做 : ```bash git push -u origin main ``` 如果是 legacy setup 使用 master 则改为: ```bash git push -u origin master ``` -u选项设置了上游(upstream),意味着以后可以直接简化成简单的push指令无需额外参数[^3]. 注意: 如果遇到权限错误可能是因为缺少身份验证机制比如SSH key配置或者是PAT(personal access tokens). 至此整个流程结束你应该能够在浏览器访问对应的repo页面看到最新同步上去的内容啦!
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值