test

Author: heisen-li

src/cargo/core/compiler/fingerprint/mod.rs

@@ -543,7 +543,8 @@ struct DepFingerprint {
 /// recompiled. Inputs to the fingerprint include source code modifications,
 /// compiler flags, compiler version, etc. This structure is not simply a
 /// `String` due to the fact that some fingerprints cannot be calculated lazily.
-///
+/// 如果指纹发生变化，则需要重新编译包本身；指纹的输入包括：代码修改、编译器标志、编译器版本；
+/// 
 /// Path sources, for example, use the mtime of the corresponding dep-info file
 /// as a fingerprint (all source files must be modified *before* this mtime).
 /// This dep-info file is not generated, however, until after the crate is
@@ -557,6 +558,8 @@ struct DepFingerprint {
 /// `DependencyQueue`, but it also needs to be retained here because Cargo can
 /// be interrupted while executing, losing the state of the `DependencyQueue`
 /// graph.
+/// 上游包重新编译的时候，所有下游依赖项也会重新编译。
+/// 通过DependencyQueue进行跟踪，但也需要保留在这里，因为 Cargo 在执行时可能会被中断，从而丢失“DependencyQueue”图的状态。
 #[derive(Serialize, Deserialize)]
 pub struct Fingerprint {
     /// Hash of the version of `rustc` used.

src/cargo/core/compiler/mod.rs

@@ -154,10 +154,13 @@ impl Executor for DefaultExecutor {
 /// Starting from the `unit`, this function recursively calls itself to build
 /// all jobs for dependencies of the `unit`. Each of these jobs represents
 /// compiling a particular package.
+/// 从“unit”开始, 该函数递归调用自身来构建“unit”依赖项的所有作业。
+/// 这些作业中的每一个都代表编译一个特定的包。
 ///
 /// Note that **no actual work is executed as part of this**, that's all done
 /// next as part of [`JobQueue::execute`] function which will run everything
 /// in order with proper parallelism.
+/// 在这个过程中，没有执行任何实际工作，属于[`JobQueue::execute`]的一部分，之后再以并行的方式进行；
 fn compile<'gctx>(
     build_runner: &mut BuildRunner<'_, 'gctx>,
     jobs: &mut JobQueue<'gctx>,