一、git将本地项目推送到 GitLab 操作步骤
前提条件
- 本地已安装 Git
- 拥有一个 GitLab 账号
- 在 GitLab 创建一个远程仓库(可为空仓库)
1.初始化 Git 仓库
进入你的项目目录,初始化 Git 仓库:
bash
cd your-project-folder
git init
2.添加、提交文件
bash
git add .
git commit -m "项目初始化"
把所有文件添加到 Git 的暂存,提交一次初始版本。
3.添加远程 GitLab 仓库地址
使用 http/https,添加远程仓库地址:
bash
git remote add origin https://gitlab.com/xxxx/your-repo.git
4.推送代码到远程仓库
我的默认分支是 master。
bash
git push -u origin master
如果你使用的是较新的 Git 版本,默认分支可能是 main
,需要用:
bash
git push -u origin main
二、常见问题排查与解决方案
问题一:nothing added to commit but untracked files present
原因 :你没有执行 git add .
或者添加失败。
解决方法:
bash
git add .
git commit -m "Initial commit"
问题二:fatal: adding files failed
+ Filename too long
原因:Windows 下 Git 默认路径长度限制为 260 个字符,某些深层结构的项目会超出限制。
解决方法:
启用 Git 的长路径支持:
bash
git config --global core.longpaths true
如果问题依旧,也可以在注册表中开启系统长路径支持:
- 打开
regedit
- 导航到:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
- 找到并修改键值
LongPathsEnabled
为1
- 重启电脑
问题三:warning: LF will be replaced by CRLF
原因:Windows 和类 Unix 系统的换行符不同(CRLF vs LF)
解决方法(可选):
这个警告通常不会影响功能,可以忽略。如果想保持一致性,可统一配置 Git 行结束符:
bash
git config --global core.autocrlf input # 保留 LF
问题四:如何查看当前 Git 仓库和远程配置?
查看当前目录是否是 Git 仓库 :
bash
git status
执行结果:

是一个 git 仓库。
查看远程仓库地址:
bash
git remote -v
查看仓库的配置项:
bash
git config --list --local
执行结果:

查看配置文件位置:
bash
cat .git/config
在 Windows 上用:
bash
type .git\config
问题五:如何更换远程仓库地址?
bash
git remote set-url origin 新地址