| <div align="center"> | |
| <picture> | |
| <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/rust-lang/www.rust-lang.org/master/static/images/rust-social-wide-dark.svg"> | |
| <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/rust-lang/www.rust-lang.org/master/static/images/rust-social-wide-light.svg"> | |
| <img alt="The Rust Programming Language: A language empowering everyone to build reliable and efficient software" | |
| src="https://raw.githubusercontent.com/rust-lang/www.rust-lang.org/master/static/images/rust-social-wide-light.svg" | |
| width="50%"> | |
| </picture> | |
| [Website][Rust] | [Getting started] | [Learn] | [Documentation] | [Contributing] | |
| </div> | |
| This is the main source code repository for [Rust]. It contains the compiler, | |
| standard library, and documentation. | |
| [Rust]: https://www.rust-lang.org/ | |
| [Getting Started]: https://www.rust-lang.org/learn/get-started | |
| [Learn]: https://www.rust-lang.org/learn | |
| [Documentation]: https://www.rust-lang.org/learn#learn-use | |
| [Contributing]: CONTRIBUTING.md | |
| ## Why Rust? | |
| - **Performance:** Fast and memory-efficient, suitable for critical services, embedded devices, and easily integrated with other languages. | |
| - **Reliability:** Our rich type system and ownership model ensure memory and thread safety, reducing bugs at compile-time. | |
| - **Productivity:** Comprehensive documentation, a compiler committed to providing great diagnostics, and advanced tooling including package manager and build tool ([Cargo]), auto-formatter ([rustfmt]), linter ([Clippy]) and editor support ([rust-analyzer]). | |
| [Cargo]: https://github.com/rust-lang/cargo | |
| [rustfmt]: https://github.com/rust-lang/rustfmt | |
| [Clippy]: https://github.com/rust-lang/rust-clippy | |
| [rust-analyzer]: https://github.com/rust-lang/rust-analyzer | |
| ## Quick Start | |
| Read ["Installation"] from [The Book]. | |
| ["Installation"]: https://doc.rust-lang.org/book/ch01-01-installation.html | |
| [The Book]: https://doc.rust-lang.org/book/index.html | |
| ## Installing from Source | |
| If you really want to install from source (though this is not recommended), see | |
| [INSTALL.md](INSTALL.md). | |
| ## Getting Help | |
| See https://www.rust-lang.org/community for a list of chat platforms and forums. | |
| ## Contributing | |
| See [CONTRIBUTING.md](CONTRIBUTING.md). | |
| For a detailed explanation of the compiler's architecture and how to begin contributing, see the [rustc-dev-guide](https://rustc-dev-guide.rust-lang.org/). | |
| ## License | |
| Rust is primarily distributed under the terms of both the MIT license and the | |
| Apache License (Version 2.0), with portions covered by various BSD-like | |
| licenses. | |
| See [LICENSE-APACHE](LICENSE-APACHE), [LICENSE-MIT](LICENSE-MIT), and | |
| [COPYRIGHT](COPYRIGHT) for details. | |
| ## Trademark | |
| [The Rust Foundation][rust-foundation] owns and protects the Rust and Cargo | |
| trademarks and logos (the "Rust Trademarks"). | |
| If you want to use these names or brands, please read the | |
| [Rust language trademark policy][trademark-policy]. | |
| Third-party logos may be subject to third-party copyrights and trademarks. See | |
| [Licenses][policies-licenses] for details. | |
| [rust-foundation]: https://rustfoundation.org/ | |
| [trademark-policy]: https://rustfoundation.org/policy/rust-trademark-policy/ | |
| [policies-licenses]: https://www.rust-lang.org/policies/licenses |