> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man7/development.7.md).
# development.7
`development` — FreeBSD 开发流程简介
## 名称
`development` FreeBSD 开发流程
## 描述
FreeBSD 开发分为三个主要子项目：doc、ports 和 src。Doc 是文档，如 FreeBSD Handbook。更多信息参见：
Lk
Ports 在 [ports(7)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man7/ports.7.md) 中进一步描述，是构建、打包和安装第三方软件的方式。更多信息参见：
Lk
最后一个 src，围绕基本系统的源代码，由内核以及通常称为 world 的库和实用程序组成。
Committer's Guide 描述了与所有 committer 相关的主题，可在以下位置找到：
Lk
FreeBSD src 开发在项目托管的 Git 仓库中进行，位于：
Lk
推送 URL 为：
Lk ssh://git\@gitrepo.FreeBSD.org/src.git
还有公共只读 Git 镜像列表：
Lk
`main` Git 分支代表 CURRENT；所有更改首先提交到 CURRENT，然后通常挑选回 STABLE，STABLE 指的是 `stable/14` 等 Git 分支。每隔几年从 CURRENT 分支出新的 STABLE，主版本号递增。然后从 STABLE 分支出版本，以连续的次版本号编号，如 `releng/14.3`
源代码树的布局在其 `README.md` 文件中描述。构建说明可在 [build(7)](/man/man7/build.7.md) 和 [release(7)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man7/release.7.md) 中找到。内核编程接口（KPI）记录在第 9 节手册页中；使用 `apropos -s 9 .` 获取列表。回归测试套件在 [tests(7)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man7/tests.7.md) 中描述。编码约定参见 [style(9)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man9/style.9.md)。
要询问有关开发的问题，请使用邮件列表，如 freebsd-arch@ 和 freebsd-hackers@：
Lk
要将补丁集成到 FreeBSD 主仓库，请使用 Phabricator；它是一个代码审查工具，允许其他开发者审查更改、提出改进建议，并最终允许他们选取更改并提交：
Lk
或 Github：
Lk
要检查 CURRENT 和 STABLE 分支的最新 FreeBSD 构建和测试状态，持续集成系统位于：
Lk
## 文件
**`/usr/src/CONTRIBUTING.md`** FreeBSD 贡献指南 **`/usr/src/tools/tools/git/git-arc.sh`** Phabricator 审查工具 **`/usr/ports/devel/freebsd-git-arc`** 作为 port 的 Phabricator 审查工具
## 实例
使用 `devel/gh` 应用 Github pull #1234 的补丁：
```sh
gh pr checkout 1234
```
使用 git-arc(1) 应用 Phabricator 审查 D1234 的补丁：
```sh
git arc patch -c D1234
```
应用从 Bugzilla 或邮件手动下载的 git-format-patch(1) 补丁 `draft.patch`：
```sh
git am draft.patch
```
应用从 Bugzilla 或邮件手动下载的补丁 `draft.diff`：
```sh
git apply draft.diff
```
## 参见
git(1), git-arc(1), [witness(4)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man4/witness.4.md), [build(7)](/man/man7/build.7.md), [hier(7)](/man/man7/hier.7.md), [ports(7)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man7/ports.7.md), [release(7)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man7/release.7.md), [tests(7)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man7/tests.7.md), [locking(9)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man9/locking.9.md), [style(9)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man9/style.9.md)
## 历史
`development` 手册页最初由 Matthew Dillon 编写，首次出现于 FreeBSD 5.0，2002 年 12 月。此后由 Eitan Adler 大量修改，以反映仓库从 Lk CVS 到 Lk Subversion 的转换。由 Edward Tomasz Napierala 为 FreeBSD 12.0 从头重写。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://book.bsdcn.org/man/man7/development.7.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.