5 构建规则 on 编程那些事儿

5.1 Unsafe 代码

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/chromium/build-rules/unsafe.html

5.1 Unsafe 代码

默认情况下，rust_static_library 禁止 unsafe Rust 代码——它不会编译。若你需要 unsafe Rust 代码，在 gn 目标中加入 allow_unsafe = true。（课程稍后我们会看到必须这样做的情形。）

5.2 从 Chromium C++ 依赖 Rust 代码

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/chromium/build-rules/depending.html

5.2 从 Chromium C++ 依赖 Rust 代码

只需把上述目标加到某个 Chromium C++ 目标的 deps 中。

import("//build/rust/rust_static_library.gni")

rust_static_library("my_rust_lib") {
 crate_root = "lib.rs"
 sources = [ "lib.rs" ]
}

# 也可以是 source_set、static_library 等。
component("preexisting_cpp") {
 deps = [ ":my_rust_lib" ]
}

我们会看到，只有当 Rust 代码暴露可从 C++ 调用的纯 C API，或我们使用 C++/Rust 互操作工具时，这种关系才有效。

5.3 Visual Studio Code

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/chromium/build-rules/vscode.html

5.3 Visual Studio Code

Rust 代码中类型常被省略，这使好用的 IDE 比在 C++ 中更有价值。Visual Studio Code 在 Chromium 中写 Rust 效果很好。用法如下：

确保 VSCode 安装了 rust-analyzer 扩展，而不是更早的 Rust 支持形式
gn gen out/Debug --export-rust-project（或对你的输出目录使用等价命令）
ln -s out/Debug/rust-project.json rust-project.json

若听众对 IDE 天然持怀疑态度，演示 rust-analyzer 的一些代码标注与探索功能可能有益。

5.4 练习

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/exercises/chromium/build-rules.html

5.4 练习

在你的 Chromium 构建中，向 //ui/base/BUILD.gn 添加一个新的 Rust 目标，内容为：

1
2
3
4
5
6
7


// Copyright 2023 Google LLC
// SPDX-License-Identifier: Apache-2.0
// SAFETY: 不存在其他同名的全局函数。
#[unsafe(no_mangle)]
pub extern "C" fn hello_from_rust() {
 println!("Hello from Rust!")
}

重要： 注意这里的 no_mangle 被 Rust 编译器视为一种 unsafety，因此你需要在 gn 目标中允许 unsafe 代码。