在 Linux 环境下,通过 VS Code 连接指定 Git 仓库的每一步命令行操作,同时也会补充 VS Code 图形界面的操作方式,方便你对照使用。
前提条件
确保你的 Linux 系统已安装:
- Git(可通过
git --version检查,未安装则执行sudo apt install git(Debian/Ubuntu)或sudo yum install git(CentOS/RHEL)) - VS Code(可通过
code --version检查,未安装可参考官网教程)
克隆仓库文件到本地
步骤 1:配置 Git 基础信息(首次使用必做)
首先需要配置 Git 的用户名和邮箱(用于提交代码时的身份标识),执行以下命令:
# 设置用户名(替换为你的名称)
git config --global user.name "你的用户名"
# 设置邮箱(替换为你的邮箱)
git config --global user.email "你的邮箱@xxx.com"
# 验证配置是否生效
git config --list
步骤 2:创建本地工作目录(可选,也可使用已有目录)
选择一个目录存放仓库代码,比如在 ~/projects 下创建:
# 创建目录(按需修改路径)
mkdir -p ~/projects/ldrs
# 进入该目录
cd ~/projects/ldrs
步骤 3:克隆远程 Git 仓库到本地
使用 git clone 命令克隆指定仓库(替换完整的仓库地址):
# 克隆仓库(将 http://60.217**/xinyuai/ldrs 替换为完整地址)
git clone http://60.217**/xinyuai/ldrs .
# 说明:末尾的 "." 表示克隆到当前目录,若省略则会创建 "ldrs" 子目录存放代码
- 如果仓库需要账号密码验证,执行后会提示输入 Git 仓库的用户名和密码,按提示输入即可。
- 若克隆失败,检查仓库地址是否正确、网络是否能访问该地址。
步骤 4:用 VS Code 打开本地仓库
克隆完成后,通过命令行打开 VS Code 并加载该仓库:
# 打开当前目录(仓库目录)
code .
步骤 5:验证 VS Code 与 Git 仓库的连接
VS Code 打开后,可通过命令行或界面验证:
命令行验证(可选)
# 查看远程仓库关联信息
git remote -v
# 输出示例(确认地址是目标仓库):
# origin http://60.217**/xinyuai/ldrs (fetch)
# origin http://60.217**/xinyuai/ldrs (push)
VS Code 界面验证(可选)
- 点击左侧边栏的「源代码管理」图标(分支图标);
- 查看顶部是否显示「master/main」(仓库分支),且无报错,说明连接成功。
补充:后续常用操作(可选)
# 拉取远程仓库最新代码
git pull origin main # 若分支是 master 则替换为 git pull origin master
# 提交代码时的基础命令(示例)
git add . # 添加所有修改文件
git commit -m "提交说明" # 提交修改
git push origin main # 推送到远程仓库
总结
- 核心步骤:配置 Git 身份 → 克隆远程仓库 → 用
code .打开仓库,即可完成 VS Code 与 Git 仓库的连接; - 克隆命令是关键:
git clone 仓库地址 本地目录,需确保仓库地址完整且网络可访问; - 若克隆时提示权限问题,优先检查仓库地址正确性和账号密码是否匹配。
仅上传本地新代码到远程 Git 仓库,无需同步仓库现有代码
前提已经进入了需要上传的文件所在目录
前提确认
- 已在目标文件所在目录 (执行
pwd可查看当前路径,确认是存放待上传文件的目录) - 确保 Git 已安装(
git --version验证,未安装则执行sudo apt install git(Debian/Ubuntu)或sudo yum install git(CentOS/RHEL))
步骤 1:配置 Git 身份(首次使用必做,已配置可跳过)
# 设置用户名(替换为你的实际名称)
git config --global user.name "你的Git用户名"
# 设置邮箱(替换为你的实际邮箱)
git config --global user.email "你的Git邮箱@xxx.com"
# 验证配置(可选)
git config --list
步骤 2:初始化本地 Git 仓库
# 在当前目录初始化空仓库(生成.git隐藏目录)
git init
步骤 3:关联远程 Git 仓库
# 将本地仓库关联到目标远程仓库(替换完整的仓库地址)
git remote add origin http://60.217**/xinyuai/ldrs
# 验证关联是否成功(可选,输出远程仓库地址即正确)
git remote -v
若提示
fatal: remote origin already exists.,说明已关联过,执行以下命令覆盖:bash
运行
git remote set-url origin http://60.217**/xinyuai/ldrs
步骤 4:暂存当前目录所有文件
# 暂存当前目录下所有待上传的文件(. 表示全部,也可指定单个文件如 git add test.py)
git add .
步骤 5:提交暂存的文件
# 提交文件并添加说明(替换为有意义的描述,比如"新增业务代码文件")
git commit -m "新增本地代码文件:xxx功能模块"
步骤 6:推送文件到远程仓库(核心步骤)
# 首次推送(强制推送,跳过本地与远程分支不一致的校验)
# 若仓库默认分支是 master,将 main 替换为 master
git push -u origin main --force
执行后会提示输入 Git 仓库的用户名 和密码,按提示输入即可(密码输入时终端无显示,正常输入即可)。
步骤 7:VS Code 关联仓库(可选,验证用)
# 在当前目录打开 VS Code,自动关联该 Git 仓库
code .
打开后点击左侧「源代码管理」图标(分支样式),可看到提交记录和远程仓库地址,确认无报错即完成。
补充:若后续需上传新文件(同一目录下)
# 进入该目录(若已在则跳过)
cd 你的文件目录路径
# 暂存新文件
git add .
# 提交
git commit -m "新增xxx文件"
# 推送(无需--force)
git push origin main
总结
- 核心命令流程:
git init→git remote add origin 仓库地址→git add .→git commit -m "说明"→git push -u origin main --force; --force仅首次推送需要,用于忽略本地与远程分支的差异(因你无需同步仓库现有代码);- 关键前提:操作全程在待上传文件所在目录执行,确保文件路径正确。