Re: [PATCH 3/4] docs/zh_CN: update rust/quick-start.rst translation

["Gary Guo" <gary@garyguo.net>]

On Wed Apr 8, 2026 at 6:05 AM BST, Ben Guo wrote:
> Update the translation of .../rust/quick-start.rst into Chinese.
>
> Update the translation through commit 5935461b4584
> ("docs: rust: quick-start: add Debian 13 (Trixie)")
>
> Reviewed-by: Dongliang Mu <dzm91@hust.edu.cn>
> Signed-off-by: Ben Guo <ben.guo@openatom.club>

Hi Ben,

Thanks on updating the doc translation. There has been new changes to
quick-start.rst on rust-next, could you update the translation to base on that
please?

Thanks,
Gary

> ---
>  .../translations/zh_CN/rust/quick-start.rst   | 190 ++++++++++++++----
>  1 file changed, 148 insertions(+), 42 deletions(-)
>
> diff --git a/Documentation/translations/zh_CN/rust/quick-start.rst b/Documentation/translations/zh_CN/rust/quick-start.rst
> index 8616556ae4d..5f0ece6411f 100644
> --- a/Documentation/translations/zh_CN/rust/quick-start.rst
> +++ b/Documentation/translations/zh_CN/rust/quick-start.rst
> @@ -13,16 +13,138 @@
>  
>  本文介绍了如何开始使用Rust进行内核开发。
>  
> +安装内核开发所需的 Rust 工具链有几种方式。一种简单的方式是使用 Linux 发行版的软件包
> +（如果它们合适的话）——下面的第一节解释了这种方法。这种方法的一个优势是，通常发行版会
> +匹配 Rust 和 Clang 所使用的 LLVM。
> +
> +另一种方式是使用 `kernel.org <https://kernel.org/pub/tools/llvm/rust/>`_ 上提
> +供的预构建稳定版本的 LLVM+Rust。这些与 :ref:`获取 LLVM <zh_cn_getting_llvm>` 中的精
> +简快速 LLVM 工具链相同，并添加了 Rust for Linux 支持的 Rust 版本。提供了两套工具
> +链："最新 LLVM" 和 "匹配 LLVM"（请参阅链接了解更多信息）。
> +
> +或者，接下来的两个 "依赖" 章节将解释每个组件以及如何通过 ``rustup``、Rust 的独立
> +安装程序或从源码构建来安装它们。
> +
> +本文档的其余部分解释了有关如何入门的其他方面。
> +
> +
> +发行版
> +------
> +
> +Arch Linux
> +**********
> +
> +Arch Linux 提供较新的 Rust 版本，因此通常开箱即用，例如::
> +
> +	pacman -S rust rust-src rust-bindgen
> +
> +
> +Debian
> +******
> +
> +Debian 13（Trixie）以及 Testing 和 Debian Unstable（Sid）提供较新的 Rust 版
> +本，因此通常开箱即用，例如::
> +
> +	apt install rustc rust-src bindgen rustfmt rust-clippy
> +
> +
> +Fedora Linux
> +************
> +
> +Fedora Linux 提供较新的 Rust 版本，因此通常开箱即用，例如::
> +
> +	dnf install rust rust-src bindgen-cli rustfmt clippy
> +
> +
> +Gentoo Linux
> +************
> +
> +Gentoo Linux（尤其是 testing 分支）提供较新的 Rust 版本，因此通常开箱即用，
> +例如::
> +
> +	USE='rust-src rustfmt clippy' emerge dev-lang/rust dev-util/bindgen
> +
> +可能需要设置 ``LIBCLANG_PATH``。
> +
> +
> +Nix
> +***
> +
> +Nix（unstable 频道）提供较新的 Rust 版本，因此通常开箱即用，例如::
> +
> +	{ pkgs ? import <nixpkgs> {} }:
> +	pkgs.mkShell {
> +	  nativeBuildInputs = with pkgs; [ rustc rust-bindgen rustfmt clippy ];
> +	  RUST_LIB_SRC = "${pkgs.rust.packages.stable.rustPlatform.rustLibSrc}";
> +	}
> +
> +
> +openSUSE
> +********
> +
> +openSUSE Slowroll 和 openSUSE Tumbleweed 提供较新的 Rust 版本，因此通常开箱
> +即用，例如::
> +
> +	zypper install rust rust1.79-src rust-bindgen clang
> +
> +
> +Ubuntu
> +******
> +
> +25.04
> +~~~~~
> +
> +最新的 Ubuntu 版本提供较新的 Rust 版本，因此通常开箱即用，例如::
> +
> +	apt install rustc rust-src bindgen rustfmt rust-clippy
> +
> +此外，需要设置 ``RUST_LIB_SRC``，例如::
> +
> +	RUST_LIB_SRC=/usr/src/rustc-$(rustc --version | cut -d' ' -f2)/library
> +
> +为方便起见，可以将 ``RUST_LIB_SRC`` 导出到全局环境中。
> +
> +
> +24.04 LTS 及更早版本
> +~~~~~~~~~~~~~~~~~~~~
> +
> +虽然 Ubuntu 24.04 LTS 及更早版本仍然提供较新的 Rust 版本，但它们需要一些额外的配
> +置，使用带版本号的软件包，例如::
> +
> +	apt install rustc-1.80 rust-1.80-src bindgen-0.65 rustfmt-1.80 \
> +		rust-1.80-clippy
> +	ln -s /usr/lib/rust-1.80/bin/rustfmt /usr/bin/rustfmt-1.80
> +	ln -s /usr/lib/rust-1.80/bin/clippy-driver /usr/bin/clippy-driver-1.80
> +
> +这些软件包都不会将其工具设置为默认值；因此应该显式指定它们，例如::
> +
> +	make LLVM=1 RUSTC=rustc-1.80 RUSTDOC=rustdoc-1.80 RUSTFMT=rustfmt-1.80 \
> +		CLIPPY_DRIVER=clippy-driver-1.80 BINDGEN=bindgen-0.65
> +
> +或者，修改 ``PATH`` 变量将 Rust 1.80 的二进制文件放在前面，并将 ``bindgen`` 设
> +置为默认值，例如::
> +
> +	PATH=/usr/lib/rust-1.80/bin:$PATH
> +	update-alternatives --install /usr/bin/bindgen bindgen \
> +		/usr/bin/bindgen-0.65 100
> +	update-alternatives --set bindgen /usr/bin/bindgen-0.65
> +
> +使用带版本号的软件包时需要设置 ``RUST_LIB_SRC``，例如::
> +
> +	RUST_LIB_SRC=/usr/src/rustc-$(rustc-1.80 --version | cut -d' ' -f2)/library
> +
> +为方便起见，可以将 ``RUST_LIB_SRC`` 导出到全局环境中。
> +
> +此外， ``bindgen-0.65`` 在较新的版本（24.04 LTS 和 24.10）中可用，但在更早的版
> +本（20.04 LTS 和 22.04 LTS）中可能不可用，因此可能需要手动构建 ``bindgen``
> +（请参见下文）。
> +
>  
>  构建依赖
>  --------
>  
>  本节描述了如何获取构建所需的工具。
>  
> -其中一些依赖也许可以从Linux发行版中获得，包名可能是 ``rustc`` , ``rust-src`` ,
> -``rust-bindgen`` 等。然而，在写这篇文章的时候，它们很可能还不够新，除非发行版跟踪最
> -新的版本。
> -
>  为了方便检查是否满足要求，可以使用以下目标::
>  
>  	make LLVM=1 rustavailable
> @@ -34,15 +156,14 @@
>  rustc
>  *****
>  
> -需要一个特定版本的Rust编译器。较新的版本可能会也可能不会工作，因为就目前而言，内核依赖
> -于一些不稳定的Rust特性。
> +需要一个较新版本的Rust编译器。
>  
>  如果使用的是 ``rustup`` ，请进入内核编译目录（或者用 ``--path=<build-dir>`` 参数
> -来 ``设置`` sub-command)并运行::
> +来 ``设置`` sub-command)，例如运行::
>  
> -	rustup override set $(scripts/min-tool-version.sh rustc)
> +	rustup override set stable
>  
> -+这将配置你的工作目录使用正确版本的 ``rustc``，而不影响你的默认工具链。
> +这将配置你的工作目录使用给定版本的 ``rustc``，而不影响你的默认工具链。
>  
>  请注意覆盖应用当前的工作目录（和它的子目录）。
>  
> @@ -54,7 +175,7 @@ rustc
>  Rust标准库源代码
>  ****************
>  
> -Rust标准库的源代码是必需的，因为构建系统会交叉编译 ``core`` 和 ``alloc`` 。
> +Rust标准库的源代码是必需的，因为构建系统会交叉编译 ``core`` 。
>  
>  如果正在使用 ``rustup`` ，请运行::
>  
> @@ -64,10 +185,10 @@ Rust标准库的源代码是必需的，因为构建系统会交叉编译 ``core
>  
>  否则，如果使用独立的安装程序，可以将Rust源码树下载到安装工具链的文件夹中::
>  
> -       curl -L "https://static.rust-lang.org/dist/rust-src-$(scripts/min-tool-version.sh rustc).tar.gz" |
> -               tar -xzf - -C "$(rustc --print sysroot)/lib" \
> -               "rust-src-$(scripts/min-tool-version.sh rustc)/rust-src/lib/" \
> -               --strip-components=3
> +	curl -L "https://static.rust-lang.org/dist/rust-src-$(rustc --version | cut -d' ' -f2).tar.gz" |
> +		tar -xzf - -C "$(rustc --print sysroot)/lib" \
> +		"rust-src-$(rustc --version | cut -d' ' -f2)/rust-src/lib/" \
> +		--strip-components=3
>  
>  在这种情况下，以后升级Rust编译器版本需要手动更新这个源代码树（这可以通过移除
>  ``$(rustc --print sysroot)/lib/rustlib/src/rust`` ，然后重新执行上
> @@ -97,24 +218,21 @@ Linux发行版中可能会有合适的包，所以最好先检查一下。
>  bindgen
>  *******
>  
> -内核的C端绑定是在构建时使用 ``bindgen`` 工具生成的。这需要特定的版本。
> -
> -通过以下方式安装它（注意，这将从源码下载并构建该工具）::
> -
> -	cargo install --locked --version $(scripts/min-tool-version.sh bindgen) bindgen-cli
> +内核的C端绑定是在构建时使用 ``bindgen`` 工具生成的。
>  
> -``bindgen`` 需要找到合适的 ``libclang`` 才能工作。如果没有找到（或者找到的
> -``libclang`` 与应该使用的 ``libclang`` 不同），则可以使用 ``clang-sys``
> -理解的环境变量（Rust绑定创建的 ``bindgen`` 用来访问 ``libclang``）:
> +例如，通过以下方式安装它（注意，这将从源码下载并构建该工具）::
>  
> +	cargo install --locked bindgen-cli
>  
> -* ``LLVM_CONFIG_PATH`` 可以指向一个 ``llvm-config`` 可执行文件。
> +``bindgen`` 使用 ``clang-sys`` crate 来查找合适的 ``libclang`` （可以静态链
> +接、动态链接或在运行时加载）。默认情况下，上面的 ``cargo`` 命令会生成一个在运行时
> +加载 ``libclang`` 的 ``bindgen`` 二进制文件。如果没有找到（或者应该使用与找到的
> +不同的 ``libclang``），可以调整该过程，例如使用 ``LIBCLANG_PATH`` 环境变量。详
> +情请参阅 ``clang-sys`` 的文档：
>  
> -* 或者 ``LIBCLANG_PATH`` 可以指向 ``libclang`` 共享库或包含它的目录。
> +	https://github.com/KyleMayes/clang-sys#linking
>  
> -* 或者 ``CLANG_PATH`` 可以指向 ``clang`` 可执行文件。
> -
> -详情请参阅 ``clang-sys`` 的文档:
> +	https://github.com/KyleMayes/clang-sys#environment-variables
>  
>  
>  开发依赖
> @@ -151,18 +269,6 @@ clippy
>  独立的安装程序也带有 ``clippy`` 。
>  
>  
> -cargo
> -*****
> -
> -``cargo`` 是Rust的本地构建系统。目前需要它来运行测试，因为它被用来构建一个自定义的标准
> -库，其中包含了内核中自定义 ``alloc`` 所提供的设施。测试可以使用 ``rusttest`` Make 目标
> -来运行。
> -
> -如果使用的是 ``rustup`` ，所有的配置文件都已经安装了该工具，因此不需要再做什么。
> -
> -独立的安装程序也带有 ``cargo`` 。
> -
> -
>  rustdoc
>  *******
>  
> @@ -223,7 +329,7 @@ Rust支持（CONFIG_RUST）需要在 ``General setup`` 菜单中启用。在其
>  如果使用的是GDB/Binutils，而Rust符号没有被demangled，原因是工具链还不支持Rust的新v0
>  mangling方案。有几个办法可以解决：
>  
> -  - 安装一个较新的版本（GDB >= 10.2, Binutils >= 2.36）。
> +- 安装一个较新的版本（GDB >= 10.2, Binutils >= 2.36）。
>  
> -  - 一些版本的GDB（例如vanilla GDB 10.1）能够使用嵌入在调试信息(``CONFIG_DEBUG_INFO``)
> -    中的pre-demangled的名字。
> +- 一些版本的GDB（例如vanilla GDB 10.1）能够使用嵌入在调试信息(``CONFIG_DEBUG_INFO``)
> +  中的pre-demangled的名字。