Build with the lockfile enforced
Refuse dependency resolution changes during CI.
bashANYcargocilocked
bash
cargo build --lockedNotes
Useful when CI should use the committed lockfile exactly and fail if it would need updating.
Rust CLI Troubleshooting: CI, Environment, Build Scripts, and Publishing
Commands for debugging CI failures, environment mismatches, build script output, installation problems, and publish checks in Rust CLI projects.
Export
Copy the compact sheet, download it, or print it.
Download
`D` dense toggle · `C` copy all
CI and environment debugging
Compare local and CI behavior with reproducible commands and config checks.
Test with the lockfile enforced
Run tests without silently changing dependencies.
bashANYcargocitestlocked
bash
cargo test --lockedNotes
A good CI default for reproducible Rust CLI builds.
bash
cargo build --frozenNotes
Useful in stricter CI contexts where both the lockfile and local cache state should already be ready.
bash
cargo config getNotes
Helpful when registry, network, target, or build settings differ between local and CI environments.
Print Rust-related environment variables
Inspect environment configuration in shells or CI jobs.
bashANYenvcargorust
bash
env | sort | grep -E '^(CARGO|RUST|CC|AR|PKG_CONFIG)'Notes
Useful for spotting overrides that affect compilers, targets, registries, or native linking.
Build scripts, install, and publish checks
Investigate build-script behavior and preflight package publication.
Inspect build-script output clearly
Use very verbose mode to surface build-script details.
bashANYcargobuild-scriptverbose
bash
cargo build -vvNotes
Build scripts communicate with Cargo through printed instructions, so extra verbosity often helps.
Minimal build.rs rerun rule
Prevent unnecessary build-script reruns.
rustANYcargobuild-scriptrerun-if-changed
rust
fn main() {
println!("cargo::rerun-if-changed=src/schema.sql");
}Notes
Useful when debugging why `build.rs` seems to rerun too often or not often enough.
Install the current CLI crate locally
Compile and install from the current path.
bashANYcargoinstallpath
bash
cargo install --path .Notes
Good for reproducing installation issues that users might hit when installing the CLI.
bash
cargo install --path . --forceNotes
Useful when testing changed package metadata or binary names during local iteration.
bash
cargo package --listNotes
Useful when publication issues are caused by missing files, ignored files, or unexpected package contents.
Validate publishing without uploading
Run Cargo’s publish checks as a dry run.
bashANYcargopublishdry-run
bash
cargo publish --dry-runNotes
A strong preflight check for Rust CLI crates before an actual registry upload.
More in Rust CLI
Rust CLI Troubleshooting: rustup, Toolchains, Components, and Targets
Commands for fixing toolchain mismatches, missing components, and cross-compilation target issues in Rust CLI projects.
Rust CLI Troubleshooting: Tests, Doctests, and Documentation
Commands for debugging failing tests, capturing output, isolating flaky cases, and fixing documentation-generation issues in Rust CLI projects.
Rust CLI Troubleshooting: Dependencies, Features, and Lockfiles
Commands for analyzing dependency trees, feature activation, duplicate crates, and lockfile behavior in Rust CLI projects.
Rust CLI Troubleshooting: Manifest, Packages, and Workspaces
Commands and examples for debugging Cargo.toml issues, package selection mistakes, and workspace confusion in Rust CLI repos.
Rust CLI Troubleshooting: Build Errors and Diagnostics
Commands for investigating compiler errors, Cargo diagnostics, verbose output, and fix suggestions in Rust CLI projects.
Rust CLI Cargo Config, Environment, Docs, and Debugging
Cargo configuration, environment variables, docs generation, and troubleshooting commands for Rust CLI development.