bashANYcargocilocked
bash
cargo build --lockedUseful 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.
bashANYcargocitestlocked
bash
cargo test --lockedA good CI default for reproducible Rust CLI builds.
bashANYcargocifrozen
bash
cargo build --frozenUseful in stricter CI contexts where both the lockfile and local cache state should already be ready.
bashANYcargoconfig
bash
cargo config getHelpful when registry, network, target, or build settings differ between local and CI environments.
bashANYenvcargorust
bash
env | sort | grep -E '^(CARGO|RUST|CC|AR|PKG_CONFIG)'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.
bashANYcargobuild-scriptverbose
bash
cargo build -vvBuild scripts communicate with Cargo through printed instructions, so extra verbosity often helps.
rustANYcargobuild-scriptrerun-if-changed
rust
fn main() {
println!("cargo::rerun-if-changed=src/schema.sql");
}Useful when debugging why `build.rs` seems to rerun too often or not often enough.
bashANYcargoinstallpath
bash
cargo install --path .Good for reproducing installation issues that users might hit when installing the CLI.
bashANYcargoinstallforce
bash
cargo install --path . --forceUseful when testing changed package metadata or binary names during local iteration.
bashANYcargopackagepublish
bash
cargo package --listUseful when publication issues are caused by missing files, ignored files, or unexpected package contents.
bashANYcargopublishdry-run
bash
cargo publish --dry-runA 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.