如何通过GitLab API读取本地txt文件内容更新仓库文件

你当前的命令无法传入本地文件内容，核心是两个未处理的问题：

1. GitLab 仓库文件操作API的content字段要求传入Base64编码后的内容，直接传入明文内容尤其是包含特殊字符的内容时，API会直接解析失败
2. 手动拼接JSON结构时，本地文件内的换行、双引号、反斜杠等特殊字符会破坏JSON语法，导致请求格式不合法

最稳妥的实现方式是用jq自动生成合法JSON，完全规避手动转义的问题，可直接运行的命令如下：

curl --request PUT \
  --header "PRIVATE-TOKEN: 替换为你自己的PRIVATE_TOKEN" \
  --header "Content-Type: application/json" \
  --data "$(jq -n \
    --arg branch "master" \
    --arg author_email "someone@email.com" \
    --arg author_name "someone" \
    --arg content "$(base64 -w 0 /tmp/output.txt)" \
    --arg commit_message "update file from local output.txt" \
    '{"branch": $branch, "author_email": $author_email, "author_name": $author_name, "content": $content, "commit_message": $commit_message, "encoding": "base64"}'
  )" \
  "https://gitlab.server.lan/api/v4/projects/xxxx/repository/files/my_file%2Fmy_yaml_file.yml"

参数说明 #

• base64 -w 0 /tmp/output.txt：将本地/tmp/output.txt的内容转换为无换行的Base64字符串，-w 0参数用于禁止base64输出自动插入换行符；如果是macOS系统，将该段替换为base64 -b 0 /tmp/output.txt即可
• jq -n：从零构建合法JSON对象，所有传入的变量会自动完成转义，无论本地文件里包含引号、换行、反斜杠还是其他特殊字符，都不会破坏JSON结构
• 请求体中新增的"encoding": "base64"字段，用于明确告知GitLab当前传入的content是Base64编码格式，API会自动解码后写入目标仓库文件

注意：不推荐手动拼接JSON传入文件内容，只要文件内容包含特殊字符就大概率出现格式错误，jq是所有Linux/macOS发行版源里都能直接安装的工具，稳定性远高于手动写转义规则。

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