如何通过Python直接向GitLab项目仓库上传文件？

不用本地Git仓库操作，直接通过python-gitlab调用GitLab API就能完成文件上传，步骤如下：

1. 安装python-gitlab库 #

先确保你安装了这个库，用pip执行安装：

pip install python-gitlab

2. 获取GitLab个人访问令牌 #

需要生成一个具备仓库写入权限的个人访问令牌：

• 登录GitLab，进入个人设置 → 访问令牌
• 填写令牌名称，勾选write_repository权限
• 生成后复制令牌并妥善保存（刷新页面后无法再查看）

3. 编写上传代码 #

基础连接与项目定位 #

先建立和GitLab的连接，并获取目标项目对象：

import gitlab

# 替换为你的GitLab实例地址（私有部署的话填自己的域名，比如https://your-gitlab.com）
gl = gitlab.Gitlab('https://gitlab.com', private_token='你的个人访问令牌')
gl.auth()  # 验证令牌有效性

# 通过项目ID或项目路径（格式如'用户名/项目名'）获取项目
project = gl.projects.get('你的项目ID或路径')

上传新文件 #

如果要上传仓库中原本没有的Excel文件：

# 文件在仓库中的存储路径（比如放到outputs子目录下）
repo_file_path = 'outputs/generated_excel.xlsx'
# 本地生成的Excel文件路径
local_file_path = './your_generated_file.xlsx'

# 以二进制模式读取文件（Excel是二进制格式，不能用文本模式）
with open(local_file_path, 'rb') as file:
    project.files.create({
        'file_path': repo_file_path,
        'branch': 'main',  # 按需替换为目标分支
        'content': file.read(),
        'commit_message': '上传自动生成的Excel数据'
    })

更新已有文件 #

如果要替换仓库中已存在的文件，需要先获取该文件的SHA值再执行更新：

repo_file_path = 'outputs/generated_excel.xlsx'
local_file_path = './updated_excel_file.xlsx'

# 获取仓库中已存在的文件对象
existing_file = project.files.get(file_path=repo_file_path, ref='main')

with open(local_file_path, 'rb') as file:
    existing_file.content = file.read()
    # 保存更新并提交到指定分支
    existing_file.save(branch='main', commit_message='更新自动生成的Excel数据')

注意事项 #

• 确保访问令牌拥有write_repository权限，否则会触发权限不足的错误
• 上传时指定的分支必须已存在
• 读取Excel文件必须用二进制模式（rb），防止文件损坏

内容的提问来源于stack exchange，提问作者OliAK