GitLab - 添加文件

GitLab - 向项目添加文件

在 GitLab 中，与任何基于 Git 的项目一样，你可以通过多种方式向项目添加文件。两种主要方法是使用命令行界面 (CLI) 配合 Git 命令，或者使用 GitLab Web 界面。

此方法涉及在你本地项目仓库中使用 Git 命令，然后将更改推送到 GitLab。

步骤 1：导航到你的项目目录

打开你的终端或命令提示符，并导航到本地 Git 仓库的根目录。

$ cd /path/to/your/project

步骤 2：创建新文件

你可以使用任何文本编辑器或像 touch（在 Linux/macOS 上）或 echo 这样的命令来创建新文件。

$ touch new_document.txt
# This creates an empty file named new_document.txt

或者，创建一个带有初始内容的文件：

$ echo "Hello World" > new_file.md

步骤 3：将文件添加到 Git 的暂存区 (Staging Area)

告诉 Git 跟踪这个新文件：

$ git add new_document.txt new_file.md
# Or, to add all new/modified files:
# $ git add .

步骤 4：提交更改

使用描述性的提交消息将更改保存到你的本地仓库历史中：

$ git commit -m "docs: Add new_document.txt and new_file.md"

步骤 5：将更改推送到 GitLab

将你的本地提交上传到 GitLab 上的远程仓库 (remote repository)。如果你的分支名称不同（例如 master, feature-branch），请将 main 替换为你的分支名称。

$ git push origin main

现在你就可以在你的 GitLab 项目中看到你的新文件了。

GitLab 的 Web 界面允许你直接在浏览器中创建和编辑文件。

步骤 1：在 GitLab 中导航到你的项目

打开你的网页浏览器，进入你在 GitLab 上的项目页面。

步骤 2：添加新文件

通常，在你的仓库文件列表上方，会有一个 ’+’ 按钮或者一个标记为 ‘Add file’（添加文件）或类似字样的按钮（例如，分支名称旁边的下拉菜单）。点击此按钮，然后选择 ‘New file’（新建文件）之类的选项。

如果你处于一个较深的目录结构中，添加文件的选项可能会特定于该目录。

步骤 3：命名文件并添加内容

你将进入一个带有编辑器的页面。

在 ‘File name’（文件名）字段中，输入你的新文件名称（例如 README.md, src/app.js）。你也可以通过在路径中包含目录来创建目录（例如 docs/guide.md 将在不存在时创建 docs 目录）。
在下方的大文本区域中，添加你的文件内容。

步骤 4：提交更改

在编辑器下方，你会找到用于输入提交消息的字段。

撰写一个简洁且具描述性的 ‘Commit message’（提交消息）。
选择你希望添加此文件的 ‘Target branch’（目标分支）。你可以直接提交到现有分支，或者选择为此更改创建一个新分支（推荐用于协作流程，以便发起新的合并请求）。

点击 ‘Commit changes’（提交更改）按钮。

步骤 5：确认

提交后，你应该会被重定向到仓库视图或文件本身，并且你的新文件将被列出。如果你选择了创建新分支，GitLab 通常会提示你创建一个合并请求。

CLI: 开发者在进行复杂更改、离线工作或已在终端中工作时首选。提供完整的 Git 功能。

Web 界面: 方便快速添加、小型编辑（例如修复文档中的错别字）或当你的本地开发环境未设置时使用。对于不熟悉 Git 命令的用户来说非常友好。