rust-lang / rust-lang/rustup

Unknown keys in rust-toolchain.toml are silently ignored

Open
#2,876 13 comments 0 reactions 1 assignee View on GitHub

@rustbot is already working on this.

Since Jul 13, 2026.

E-easy E-mentor enhancement help wanted
Dominant language
Rust
Stars
7k
Forks
1.1k
Avg merge
22h 40m
Merged PRs (30d)
46

Description

I was adding a rust-toolchain.toml file to a project, and ended up in a very confusing state where it was clearly being picked up (e.g. rustup show had the overridden by .../rust-toolchain.toml text) but my selected channel wasn't being respected. I eventually realized that I had used channnel = "1.56.0" rather than channel = "1.56.0"!

It seems like rustup should complain more loudly about this kind of misconfiguration. If actually forbidding unknown fields isn't desirable, it'd be great to at least warn about unused keys found when parsing the configuration using serde_ignored.

This issue has been assigned to @ychampion via this comment.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.