048.md

# 项目[](#项目 "Permalink")

您可以创建用于托管代码库的项目，可以通过项目进行 Issue 管理，进行代码协作，并使用内置的  CI / CD 持续构建，测试和部署应用程序。

您可以设置您的项目为[公开](../../public_access/public_access.html)或[私有](../../public_access/public_access.html)，我们也不限制您创建的私有项目数量。

## 项目功能[](#项目功能 "Permalink")

创建项目时，您可以使用众多功能：

**代码仓库:**

*   [Issue](issues/index.html) ：与您的团队讨论问题内的实现
    *   [看板](issue_board.html) ：组织工作流程并确定其优先级
*   [代码仓库](repository/index.html) ：将代码托管在完全集成的平台中
    *   [分支](repository/branches/index.html) ：使用 Git 分支策略在代码上进行协作
    *   [受保护的分支机构](protected_branches.html) ：防止协作者弄乱历史记录或在未经审查的情况下推送代码
    *   [受保护的标签](protected_tags.html) ：控制谁有权创建标签，并防止意外更新或删除
    *   [储存库镜像](repository/repository_mirroring.html)
    *   [签署提交](gpg_signed_commits/index.html) ：使用 GPG 签署您的提交
    *   [部署令牌](deploy_tokens/index.html) ：管理基于项目的部署令牌，这些令牌允许永久访问存储库和 Container Registry.
*   [Web IDE](web_ide/index.html)

**Release 及合并请求：**

*   [Issue](issues/index.html) ：与您的团队讨论问题内的实现
    *   [发行板](issue_board.html) ：组织工作流程并确定其优先级
*   [合并请求](merge_requests/index.html) ：应用您的分支策略并获得团队的审查
    *   [合并请求批准](merge_requests/merge_request_approvals.html) ：实施更改之前[请求批准](merge_requests/merge_request_approvals.html)
    *   [修复合并中的冲突](merge_requests/resolve_conflicts.html) ：直接从网页中使用 Git diff 工具
    *   [审查应用程序](../../ci/review_apps/index.html) ：按分支实时预览合并请求中建议的更改结果
*   [标签](labels.html) ：按标签整理问题并合并请求
*   [时间跟踪](time_tracking.html) ：跟踪估计在完成问题或合并请求上花费的时间和时间
*   [里程碑](milestones/index.html) ：朝着目标日期迈进
*   [描述模板](description_templates.html) ：为项目定义特定于上下文的模板，并为您的项目合并请求描述字段
*   [斜杠命令（快速操作）](quick_actions.html) ：针对问题或合并请求的常见操作的文本快捷方式
*   [自动完成字符](autocomplete_characters.html) ：自动完成对用户，组，问题，合并请求和其他 GitLab 元素的引用.
*   [Web IDE](web_ide/index.html)

**亚搏体育 app CI / CD：**

*   [GitLab CI / CD](../../ci/README.html) ：GitLab 内置的[持续集成，交付和部署](https://about.gitlab.com/blog/2016/08/05/continuous-integration-delivery-and-deployment-with-gitlab/)工具
    *   [容器注册表](../packages/container_registry/index.html) ：开箱即用地构建和推送 Docker 映像
    *   [自动部署](../../topics/autodevops/stages.html#auto-deploy) ：配置 GitLab CI / CD 以自动设置应用程序的部署
    *   [启用和禁用 GitLab CI / CD](../../ci/enable_or_disable_ci.html)
    *   [管道](../../ci/pipelines/index.html) ：从 UI 配置和可视化 GitLab CI / CD 管道
        *   [计划的管道](../../ci/pipelines/schedules.html) ：计划管道以在选定的时间开始
        *   [管道图](../../ci/pipelines/index.html#visualize-pipelines) ：通过 UI 查看整个管道
        *   [作业工件](../../ci/pipelines/job_artifacts.html) ：定义，浏览和下载作业工件
        *   [管道设置](../../ci/pipelines/settings.html) ：设置 Git 策略（选择从作业中的 GitLab 提取存储库的默认方式），超时（定义可以运行作业的最长时间（以分钟为`.gitlab-ci.yml` ）） `.gitlab-ci.yml`自定义路径，测试覆盖率分析，管道的可见性等
    *   [Kubernetes 集群集成](clusters/index.html) ：将您的 GitLab 项目与 Kubernetes 集群连接
    *   [功能标志](../../operations/feature_flags.html) ：功能标志允许您通过动态切换某些功能来以不同的方式发布项目
*   [GitLab Pages](pages/index.html) ：使用[GitLab Pages](pages/index.html)构建，测试和部署您的静态网站

**其他特性：**

*   [Wiki](wiki/index.html) ：在集成的 Wiki 中记录您的 GitLab 项目.
*   [片段](../snippets.html) ：存储，共享和协作代码片段.
*   [价值流分析](cycle_analytics.html) ：查看您的开发生命周期.
*   [见解](insights/index.html) ：配置对您的项目至关重要的见解.
*   [安全仪表板](security_dashboard.html) ：安全仪表板.
*   [语法突出显示](highlighting.html) ：一种自定义代码块的替代方法，它替代了 GitLab 的默认语言选择.
*   [徽章](badges.html) ：项目概述的徽章.
*   [发行版](releases/index.html) ：一种跟踪项目中可交付成果的方式，可作为源，构建输出，其他元数据和与代码的发行版本相关的其他工件的快照.
*   [Conan 软件包](../packages/conan_repository/index.html) ：您在 GitLab 中的私人 Conan 存储库.
*   [Maven 软件包](../packages/maven_repository/index.html) ：您在 GitLab 中的私有 Maven 存储库.
*   [NPM 软件包](../packages/npm_registry/index.html) ：您在 GitLab 中的私有 NPM 软件包注册表.
*   [代码所有者](code_owners.html) ：为某些文件指定代码所有者
*   [许可证合规性](../compliance/license_compliance/index.html) ：批准和拒绝项目的许可证.
*   [依赖项列表](../application_security/dependency_list/index.html) ：查看项目依赖项.
*   [要求](requirements/index.html) ：要求使您可以创建标准来检查产品.
*   [静态站点编辑器](static_site_editor/index.html) ：无需事先了解代码库或 Git 命令，即可在静态网站上快速编辑内容.
*   [代码智能](code_intelligence.html) ：代码导航功能.

### Project integrations[](#project-integrations "Permalink")

[将您的项目](integrations/index.html)与 Jira，Mattermost，Kubernetes，Slack 等进行[集成](integrations/index.html) .

## New project[](#new-project "Permalink")

了解如何在 GitLab 中[创建一个新项目](../../gitlab-basics/create-project.html) .

### Fork a project[](#fork-a-project "Permalink")

您可以[派生一个项目](repository/forking_workflow.html) ，以便：

*   通过分叉项目并创建从分支到上游项目的合并请求来进行代码协作
*   分叉一个示例项目以在其顶部工作

### Star a project[](#star-a-project "Permalink")

您可以为项目加注星标，以使其更容易找到您经常使用的项目. 项目拥有的明星数量可以表明其受欢迎程度.

为项目加注星标：

1.  转到要加注星标的项目的主页.
2.  在页面的右上角，点击**星标** .

要查看已加星标的项目，请执行以下操作：

1.  单击导航栏中的**项目** .
2.  Click **已加星标的项目**.
3.  GitLab 显示有关已加星标项目的信息，包括：

    *   项目描述，包括名称，描述和图标
    *   已为该项目加注星标的次数
    *   Number of times this project has been forked
    *   打开的合并请求数
    *   未解决问题的数量

### Explore projects[](#explore-projects "Permalink")

您可以探索 GitLab 上可用的其他流行项目. 探索项目：

1.  单击导航栏中的**项目** .
2.  Click **探索项目**.

GitLab 显示一个项目列表，按上次更新日期排序. 要查看具有最多[星星的](#star-a-project)项目，请单击" **最多星星"** . 要查看过去一个月中评论数量最多的项目，请点击**趋势** .

## Project settings[](#project-settings "Permalink")

将项目的可见性级别和访问级别设置为各个页面，并执行诸如归档，重命名或传输项目的操作.

通读有关[项目设置](settings/index.html)的文档.

## Import or export a project[](#import-or-export-a-project "Permalink")

*   [Import a project](import/index.html) from:
    *   [GitHub to GitLab](import/github.html)
    *   [Bitbucket to GitLab](import/bitbucket.html)
    *   [Gitea to GitLab](import/gitea.html)
    *   [FogBugz to GitLab](import/fogbugz.html)
*   [Export a project from GitLab](settings/import_export.html#exporting-a-project-and-its-data)
*   [Importing and exporting projects between GitLab instances](settings/import_export.html)

## Remove a project[](#remove-a-project "Permalink")

要删除项目，请首先导航到该项目的主页.

1.  导航至**设置>常规** .
2.  展开**高级**部分.
3.  向下滚动到" **删除项目"**部分.
4.  Click **移除专案**
5.  通过输入所需的文本来确认此操作.

### Delayed removal[](#delayed-removal-premium "Permalink")

默认情况下，单击以删除项目后会延迟 7 天. 管理员可以在这段时间内恢复项目. [管理员可以更改](../admin_area/settings/visibility_and_access_controls.html#default-deletion-adjourned-period-premium-only)此延迟.

管理员可以查看所有待删除项目. 如果您是管理员，请转到顶部导航栏，单击" **项目">"您的项目"** ，然后选择"已**删除的项目"**选项卡. 管理员可以从此选项卡还原任何项目.

## CI/CD for external repositories[](#cicd-for-external-repositories-premium "Permalink")

您可以将存储库作为 CI / CD 项目连接，而不是将存储库直接导入到 GitLab.

通读[CI / CD 上有关外部存储库](../../ci/ci_cd_for_external_repos/index.html)的文档.

## Project members[](#project-members "Permalink")

了解如何[将成员添加到您的项目中](members/index.html) .

## Project activity[](#project-activity "Permalink")

要查看项目的活动，请导航至**项目概述>活动** . 在此处，您可以单击选项卡以查看**所有**活动，或查看按**Push 事件** ， **Merge 事件** ， **Issue 事件** ， **Comment** ， **Team**和**Wiki**过滤的**活动** .

### Leave a project[](#leave-a-project "Permalink")

当项目属于组时（在[组命名空间下](../group/index.html#namespaces) ）， **离开项目**将仅显示在项目的仪表板上. 如果您选择退出项目，那么您将不再是项目成员，因此无法参与.

## Project’s landing page[](#projects-landing-page "Permalink")

项目的登录页面根据项目的可见性设置和用户权限显示不同的信息.

对于公共项目以及[有权查看该项目代码](../permissions.html#project-members-permissions)的内部和私有项目的成员：

*   显示[`README`文件或索引文件的](repository/#repository-readme-and-index-files)内容（如果有），然后显示项目存储库中的目录列表.
*   如果项目不包含这些文件中的任何一个，则访问者将看到存储库的文件和目录列表.

对于没有权限查看项目代码的用户：

*   显示维基主页（如果有）.
*   显示项目中的问题列表.

## Redirects when changing repository paths[](#redirects-when-changing-repository-paths "Permalink")

当存储库路径更改时，从旧位置平稳过渡到新位置至关重要. GitLab 提供两种重定向：Web UI 和 Git 推/拉重定向.

根据情况，可能会有所不同.

When [renaming a user](../profile/index.html#changing-your-username), [changing a group path](../group/index.html#changing-a-groups-path) or [renaming a repository](settings/index.html#renaming-a-repository):

*   名称空间及其下的任何内容（例如项目）的现有 Web URL 将重定向到新 URL.
*   从 GitLab 10.3 开始，命名空间下项目的现有 Git 远程 URL 将重定向到新的远程 URL. 每次将其推/拉到更改位置的存储库时，都会显示一条警告消息，提示您更新遥控器，而不是拒绝操作. 这意味着在重命名后，任何自动化脚本或 Git 客户端将继续工作，从而使任何过渡都更加顺畅.
*   The redirects will be available as long as the original path is not claimed by another group, user or project.

## Use your project as a Go package[](#use-your-project-as-a-go-package "Permalink")

任何项目都可以用作 Go 包. GitLab 会正确响应`go get`和`godoc.org`发现请求，包括[`go-import`](https://s0golang0org.icopy.site/cmd/go/)和[`go-source`](https://github.com/golang/gddo/wiki/Source-Code-Links)元标记.

私有项目（包括子组中的项目）可以用作 Go 包，但可能需要进行配置才能正常工作. 无论身份验证或授权如何，GitLab 都会正确响应以`go get` *不在*子组中的项目的发现请求. 要使用子组中的私有项目作为 Go 包，必须进行[身份验证](#authenticate-go-requests) . 否则，GitLab 会将子组中私有项目的路径截断到前两个段，从而导致`go get`失败.

GitLab 实现了自己的 Go 代理. 此功能必须由管理员启用，并且需要其他配置. 请参阅[GitLab Go 代理](../packages/go_proxy/index.html) .

### Disable Go module features for private projects[](#disable-go-module-features-for-private-projects "Permalink")

In Go 1.12 and later, Go queries module proxies and checksum databases in the process of [fetching a module](../../development/go_guide/dependencies.html#fetching). This can be selectively disabled with `GOPRIVATE` (disable both), [`GONOPROXY`](../../development/go_guide/dependencies.html#proxies) (disable proxy queries), and [`GONOSUMDB`](../../development/go_guide/dependencies.html#fetching) (disable checksum queries).

`GOPRIVATE` ， `GONOPROXY`和`GONOSUMDB`是 Go 模块和 Go 模块前缀的逗号分隔列表. 例如， `GOPRIVATE=gitlab.example.com/my/private/project`将禁用对该项目的查询，而`GOPRIVATE=gitlab.example.com`将禁用`GOPRIVATE=gitlab.example.com` *所有*项目的查询. 如果模块名称或其前缀出现在`GOPRIVATE`或`GONOPROXY` ，则 Go 不会查询模块代理. 如果模块名称或其前缀出现在`GONOPRIVATE`或`GONOSUMDB` ，则 Go 不会查询校验和数据库.

### Authenticate Go requests[](#authenticate-go-requests "Permalink")

要验证对 Go 私有项目的请求，请在密码字段中使用[`.netrc`文件](https://ec.haxx.se/usingcurl-netrc.html)和[个人访问令牌](../profile/personal_access_tokens.html) . **仅当可以通过 HTTPS 访问您的 GitLab 实例时，此方法才有效.** `go`命令不会通过不安全的连接传输凭据. 这将验证 Go 直接发出的所有 HTTPS 请求，但不会验证通过 Git 发出的请求.

例如：

```
machine example.gitlab.com
login <gitlab_user_name>
password <personal_access_token> 
```

**注意：**在 Windows 上，Go 读取`~/_netrc`而不是`~/.netrc` .

### Authenticate Git fetches[](#authenticate-git-fetches "Permalink")

如果无法从代理中获取模块，Go 将退回到使用 Git（对于 GitLab 项目）. Git 将使用`.netrc`来认证请求. 另外，可以将 Git 配置为在请求 URL 中嵌入特定的凭据，或者使用 SSH 代替 HTTPS（因为 Go 始终使用 HTTPS 来获取 Git 存储库）：

```
# embed credentials in any request to GitLab.com:
git config --global url."https://${user}:${personal_access_token}@gitlab.example.com".insteadOf "https://gitlab.example.com"

# use SSH instead of HTTPS:
git config --global url."git@gitlab.example.com".insteadOf "https://gitlab.example.com" 
```

## Access project page with project ID[](#access-project-page-with-project-id "Permalink")

在 GitLab 11.8 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/53671) .

要使用项目 ID 从 GitLab UI 快速访问项目，请在浏览器或其他访问项目的工具中访问`/projects/:id` URL.

## Project aliases[](#project-aliases-premium-only "Permalink")

[Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/3264) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.1.

将存储库迁移到 GitLab 并被其他系统访问时，能够使用相同的名称访问它们非常有用，尤其是当它们很多时. 它降低了在大量系统中更改大量 Git URL 的风险.

manbetx 客户端打不开提供了功能来帮助这一点. 在 GitLab 中，通常使用名称空间和项目名称访问存储库. 也可以通过项目别名访问它们. 此功能仅在通过 SSH 的 Git 上可用.

项目别名只能通过 API 创建，并且只能由 GitLab 管理员创建. 有关更多详细信息，请遵循[Project Aliases API 文档](../../api/project_aliases.html) .

一旦为项目创建了别名（例如，项目`https://gitlab.com/gitlab-org/gitlab`的别名`gitlab` ），就可以使用别名（例如`git clone git@gitlab.com:gitlab.git` ）来克隆存储库. `git clone git@gitlab.com:gitlab.git`而不是`git clone git@gitlab.com:gitlab-org/gitlab.git` ）.

## Project APIs[](#project-apis "Permalink")

您的项目可以使用许多[API](../../api/README.html) ：

*   [Badges](../../api/project_badges.html)
*   [Clusters](../../api/project_clusters.html)
*   [Threads](../../api/discussions.html)
*   [General](../../api/projects.html)
*   [Import/export](../../api/project_import_export.html)
*   [Issue Board](../../api/boards.html)
*   [Labels](../../api/labels.html)
*   [Markdown](../../api/markdown.html)
*   [Merge Requests](../../api/merge_requests.html)
*   [Milestones](../../api/milestones.html)
*   [Services](../../api/services.html)
*   [Snippets](../../api/project_snippets.html)
*   [Templates](../../api/project_templates.html)
*   [Traffic](../../api/project_statistics.html)
*   [Variables](../../api/project_level_variables.html)
*   [Aliases](../../api/project_aliases.html)