Learn Rust - Rust Programming Language

<!doctype html> <html lang="en-US"> <head> <meta charset="utf-8"> <title> Learn Rust - Rust Programming Language </title> <meta name="viewport" content="width=device-width,initial-scale=1.0"> <meta name="description" content="A language empowering everyone to build reliable and efficient software.">  <meta name="twitter:card" content="summary"> <meta name="twitter:site" content="@rustlang"> <meta name="twitter:creator" content="@rustlang"> <meta name="twitter:title" content="Learn Rust"> <meta name="twitter:description" content="A language empowering everyone to build reliable and efficient software."> <meta name="twitter:image" content="https://www.rust-lang.org/static/images/rust-social.jpg">  <meta property="og:title" content="Learn Rust" /> <meta property="og:description" content="A language empowering everyone to build reliable and efficient software."> <meta property="og:image" content="https://www.rust-lang.org/static/images/rust-social-wide.jpg" /> <meta property="og:type" content="website" /> <meta property="og:locale" content="en_US" />  <link rel="stylesheet" href="/static/styles/a11y-dark.css"/> <link rel="stylesheet" href="/static/styles/vendor_10880690442070639967.css"/> <link rel="stylesheet" href="/static/styles/fonts_8049871103083011125.css"/> <link rel="stylesheet" href="/static/styles/app_1609526410131002304.css"/>  <link rel="apple-touch-icon" sizes="180x180" href="/static/images/apple-touch-icon.png?v=ngJW8jGAmR"> <link rel="icon" sizes="16x16" type="image/png" href="/static/images/favicon-16x16.png"> <link rel="icon" sizes="32x32" type="image/png" href="/static/images/favicon-32x32.png"> <link rel="icon" type="image/svg+xml" href="/static/images/favicon.svg"> <link rel="manifest" href="/static/images/site.webmanifest?v=ngJW8jGAmR"> <link rel="mask-icon" href="/static/images/safari-pinned-tab.svg?v=ngJW8jGAmR" color="#000000"> <meta name="msapplication-TileColor" content="#ffffff"> <meta name="msapplication-config" content="/static/images/browserconfig.xml?v=ngJW8jGAmR"> <meta name="theme-color" content="#ffffff">  <script src="/static/scripts/highlight.pack.js" defer></script> <script src="/static/scripts/init.js" defer></script> </head> <body> <nav class="flex flex-row justify-center justify-end-l items-center flex-wrap ph2 pl3-ns pr3-ns pb3"> <div class="brand flex-auto w-100 w-auto-l self-start tc tl-l"> <a href="/" class="brand"> <img class="v-mid ml0-l" alt="Rust Logo" src="/static/images/rust-logo-blk.svg"> <span class="dib ml1 ml0-l">Rust</span> </a> </div> <ul class="nav list w-100 w-auto-l flex flex-none flex-row flex-wrap justify-center justify-end-l items-center pv2 ph0 ph4-ns"> <li class="tc pv2 ph2 ph4-ns flex-20-s"><a href="/tools/install">Install</a></li> <li class="tc pv2 ph2 ph4-ns flex-20-s"><a href="/learn">Learn</a></li> <li class="tc pv2 ph2 ph4-ns flex-20-s"><a href="https://play.rust-lang.org/">Playground</a></li> <li class="tc pv2 ph2 ph4-ns flex-20-s"><a href="/tools">Tools</a></li> <li class="tc pv2 ph2 ph4-ns flex-20-s"><a href="/governance">Governance</a></li> <li class="tc pv2 ph2 ph4-ns flex-20-s"><a href="/community">Community</a></li> <li class="tc pv2 ph2 ph4-ns flex-20-s"><a href="https://blog.rust-lang.org/">Blog</a></li> </ul> <div class=" w-100 w-auto-l flex-none flex justify-center pv4 pv-0-l languages"> <div class="select"> <label for="language-nav" class="hidden">Language</label> <select id="language-nav" data-current-lang="en-US"> <option title="English (en-US)" value="en-US">English (en-US)</option> <option title="Español (es)" value="es">Español (es)</option> <option title="Français (fr)" value="fr">Français (fr)</option> <option title="Italiano (it)" value="it">Italiano (it)</option> <option title="日本語 (ja)" value="ja">日本語 (ja)</option> <option title="Português (pt-BR)" value="pt-BR">Português (pt-BR)</option> <option title="Русский (ru)" value="ru">Русский (ru)</option> <option title="Türkçe (tr)" value="tr">Türkçe (tr)</option> <option title="简体中文 (zh-CN)" value="zh-CN">简体中文 (zh-CN)</option> <option title="正體中文 (zh-TW)" value="zh-TW">正體中文 (zh-TW)</option> </select> </div> </div> </nav> <main> <header class="mt3 mt2-ns mb4 mb5-ns tc tl-ns"> <div class="w-100 mw-none ph3 mw8-m mw9-l center f3"> <h1>Learn Rust</h1> </div> </header> <section id="learn-begin" class="green"> <div class="w-100 mw-none ph3 mw8-m mw9-l center f3"> <header> <h2>Get started with Rust</h2> <div class="highlight"></div> </header> <section class="flex flex-column flex-row-l pv0-l"> <div class="flex flex-row flex-column-l justify-between-l mw8 measure-wide-l pb4 pb5-m pb0-ns ph4-l"> <div class="v-top pt3-l measure-wide-l flex-l flex-column-l flex-auto-l"> <p class="flex-grow-1">Affectionately nicknamed “the book,” <cite>The Rust Programming Language</cite> will give you an overview of the language from first principles. You’ll build a few projects along the way, and by the end, you’ll have a solid grasp of the language.</p> <div class="buttons"> <a class="button button-secondary" href="https://doc.rust-lang.org/book/">Read the Book!</a> </div> </div> </div> <div class="flex flex-row flex-column-l justify-between-l mw8 measure-wide-l pb4 pb5-m pb0-ns ph4-l"> <div class="v-top pt3-l measure-wide-l flex-l flex-column-l flex-auto-l"> <p class="flex-grow-1">Alternatively, Rustlings guides you through downloading and setting up the Rust toolchain, and teaches you the basics of reading and writing Rust syntax, on the command line. It's an alternative to Rust by Example that works with your own environment.</p> <div class="buttons"> <a class="button button-secondary" href="https://github.com/rust-lang/rustlings/">Do the Rustlings course!</a> </div> </div> </div> <div class="flex flex-row flex-column-l justify-between-l mw8 measure-wide-l pb4 pb5-m pb0-ns ph4-l"> <div class="v-top pt3-l measure-wide-l flex-l flex-column-l flex-auto-l"> <p class="flex-grow-1">If reading multiple hundreds of pages about a language isn’t your style, then Rust By Example has you covered. While the book talks about code with a lot of words, RBE shows off a bunch of code, and keeps the talking to a minimum. It also includes exercises!</p> <div class="buttons"> <a class="button button-secondary" href="https://doc.rust-lang.org/rust-by-example/">Check out Rust by Example!</a> </div> </div> </div> </section> </div> </section> <section id="learn-use" class="white"> <div class="w-100 mw-none ph3 mw8-m mw9-l center f3"> <header> <h2 class="black"> Documentation </h2> <div class="highlight"></div> </header> <div> <h3>Read the core documentation</h3> <p>All of this documentation is also available locally using the <code>rustup doc</code> command, which will open up these resources for you in your browser without requiring a network connection!</p> <section class="flex flex-column"> <div class="pt3 flex flex-column flex-row-l items-center-l mb4-l"> <a href="https://doc.rust-lang.org/std/index.html" class="button button-secondary mw6-l w-100">The standard library</a> <p class="pl4-l ma0-l mt1 mb3"> Comprehensive guide to the Rust standard library APIs. </p> </div> <div class="pt4 pt3-l flex flex-column flex-row-l items-center-l mb4-l"> <a href="https://doc.rust-lang.org/edition-guide/index.html" class="button button-secondary mw6-l w-100">Edition Guide</a> <p class="pl4-l ma0-l mt1 mb3"> Guide to the Rust editions. </p> </div> <div class="pt4 pt3-l flex flex-column flex-row-l items-center-l mb4-l"> <a href="https://doc.rust-lang.org/cargo/index.html" class="button button-secondary mw6-l w-100">Cargo Book</a> <p class="pl4-l ma0-l mt1 mb3"> A book on Rust’s package manager and build system. </p> </div> <div class="pt4 pt3-l flex flex-column flex-row-l items-center-l mb4-l"> <a href="https://doc.rust-lang.org/rustdoc/index.html" class="button button-secondary mw6-l w-100">rustdoc Book</a> <p class="pl4-l ma0-l mt1 mb3"> Learn how to make awesome documentation for your crate. </p> </div> <div class="pt4 pt3-l flex flex-column flex-row-l items-center-l mb4-l"> <a href="https://doc.rust-lang.org/rustc/index.html" class="button button-secondary mw6-l w-100">rustc Book</a> <p class="pl4-l ma0-l mt1 mb3"> Familiarize yourself with the knobs available in the Rust compiler. </p> </div> <div class="pt4 pt3-l flex flex-column flex-row-l items-center-l mb4-l"> <a href="https://doc.rust-lang.org/error-index.html" class="button button-secondary mw6-l w-100">Compiler Error Index</a> <p class="pl4-l mb0 mt1 ma0-l"> In-depth explanations of the errors you may see from the Rust compiler. </p> </div> </section> </div> <hr/> <div> <h3>Build your skills in an application domain</h3> <section class="flex flex-column"> <div class="pt3 flex flex-column flex-row-l items-center-l mb4-l"> <a href="https://rust-cli.github.io/book/index.html" class="button button-secondary mw6-l w-100"> Command Line Book </a> <p class="pl4-l ma0-l mt1 mb3"> Learn how to build effective command line applications in Rust. </p> </div> <div class="pt4 pt3-l flex flex-column flex-row-l items-center-l mb4-l"> <a href="https://rustwasm.github.io/docs/book/" class="button button-secondary mw6-l w-100"> WebAssembly Book </a> <p class="pl4-l ma0-l mt1 mb3"> Use Rust to build browser-native libraries through WebAssembly. </p> </div> <div class="pt4 pt3-l flex flex-column flex-row-l items-center-l mb4-l"> <a href="https://doc.rust-lang.org/embedded-book" class="button button-secondary mw6-l w-100"> Embedded Book </a> <p class="pl4-l mb0 mt1 ma0-l"> Become proficient with Rust for Microcontrollers and other embedded systems. </p> </div> </section> </div> </div> </section> <section id="learn-master" class="purple"> <div class="w-100 mw-none ph3 mw8-m mw9-l center f3"> <header> <h2>Master Rust</h2> <div class="highlight"></div> </header> <p>Curious about the darkest corners of the language? Here’s where you can get into the nitty-gritty:</p> <section class="flex flex-column flex-row-l pv0-l"> <div class="flex flex-row flex-column-l justify-between-l mw8 measure-wide-l pv4 pv5-m pv6-ns ph4-l"> <div class="v-top tc-l"> <img src="/static/images/reference.svg" alt="A bookshelf icon" class="mw3 mw4-ns" /> </div> <div class="v-top pl4 pl0-l pt0 pt3-l measure-wide-l flex-l flex-column-l flex-auto-l justify-between-l"> <p>The Reference is not a formal spec, but is more detailed and comprehensive than the book.</p> <a class="button button-secondary" href="https://doc.rust-lang.org/reference/index.html"> Read the reference </a> </div> </div> <div class="flex flex-row flex-column-l justify-between-l mw8 measure-wide-l pv4 pv5-m pv6-ns ph4-l"> <div class="v-top tc-l"> <img src="/static/images/nomicon.svg" alt="Two hands cradling fire" class="mw3 mw4-ns" /> </div> <div class="v-top pl4 pl0-l pt0 pt3-l measure-wide-l flex-l flex-column-l flex-auto-l justify-between-l"> <p>The Rustonomicon is your guidebook to the dark arts of unsafe Rust. It’s also sometimes called “the ’nomicon.”</p> <a class="button button-secondary" href="https://doc.rust-lang.org/nomicon/index.html"> Read the ’nomicon </a> </div> </div> <div class="flex flex-row flex-column-l justify-between-l mw8 measure-wide-l pv3 pv5-m pv6-ns ph4-l"> <div class="v-top tc-l"> <img src="/static/images/unstable.svg" alt="A hand sharing sparkles" class="mw3 mw4-ns" /> </div> <div class="v-top pl4 pl0-l pt0 pt3-l measure-wide-l flex-l flex-column-l flex-auto-l justify-between-l"> <p>The Unstable Book has documentation for unstable features that you can only use with nightly Rust.</p> <a class="button button-secondary" href="https://doc.rust-lang.org/nightly/unstable-book/index.html"> Read the unstable book </a> </div> </div> </section> </div> </section> </main> <footer> <div class="w-100 mw-none ph3 mw8-m mw9-l center f3"> <div class="flex flex-column flex-row-ns pv0-l"> <div class="flex flex-column mw8 w-100 measure-wide-l pv2 pv5-m pv2-ns ph4-m ph4-l" id="get-help"> <h4>Get help!</h4> <ul> <li><a href="/learn">Documentation</a></li> <li><a href="http://forge.rust-lang.org">Rust Forge (Contributor Documentation)</a></li> <li><a href="https://users.rust-lang.org">Ask a Question on the Users Forum</a></li> </ul> <div class="languages"> <div class="select"> <label for="language-footer" class="hidden">Language</label> <select id="language-footer"> <option title="English (en-US)" value="en-US">English (en-US)</option> <option title="Español (es)" value="es">Español (es)</option> <option title="Français (fr)" value="fr">Français (fr)</option> <option title="Italiano (it)" value="it">Italiano (it)</option> <option title="日本語 (ja)" value="ja">日本語 (ja)</option> <option title="Português (pt-BR)" value="pt-BR">Português (pt-BR)</option> <option title="Русский (ru)" value="ru">Русский (ru)</option> <option title="Türkçe (tr)" value="tr">Türkçe (tr)</option> <option title="简体中文 (zh-CN)" value="zh-CN">简体中文 (zh-CN)</option> <option title="正體中文 (zh-TW)" value="zh-TW">正體中文 (zh-TW)</option> </select> </div> </div> </div> <div class="flex flex-column mw8 w-100 measure-wide-l pv2 pv5-m pv2-ns ph4-m ph4-l"> <h4>Terms and policies</h4> <ul> <li><a href="/policies/code-of-conduct">Code of Conduct</a></li> <li><a href="/policies/licenses">Licenses</a></li> <li><a href="https://foundation.rust-lang.org/policies/logo-policy-and-media-guide/">Logo Policy and Media Guide</a></li> <li><a href="/policies/security">Security Disclosures</a></li> <li><a href="https://foundation.rust-lang.org/policies/privacy-policy/">Privacy Notice</a></li> <li><a href="/policies">All Policies</a></li> </ul> </div> <div class="flex flex-column mw8 w-100 measure-wide-l pv2 pv5-m pv2-ns ph4-m ph4-l"> <h4>Social</h4> <div class="flex flex-row flex-wrap items-center"> <a rel="me" href="https://social.rust-lang.org/@rust" target="_blank"><img src="/static/images/mastodon.svg" alt="Mastodon" title="Mastodon" /></a> <a href="https://twitter.com/rustlang" target="_blank"><img src="/static/images/twitter.svg" alt="twitter logo" title="Twitter"/></a> <a href="https://www.youtube.com/channel/UCaYhcUwRBNscFNUKTjgPFiA" target="_blank"><img class="pv2" src="/static/images/youtube.svg" alt="youtube logo" title="YouTube"/></a> <a href="https://discord.gg/rust-lang" target="_blank"><img src="/static/images/discord.svg" alt="discord logo" title="Discord"/></a> <a href="https://github.com/rust-lang" target="_blank"><img src="/static/images/github.svg" alt="github logo" title="GitHub"/></a> </div> </div> </div> <div class="attribution"> <p> Maintained by the Rust Team. See a bug? <a href="https://github.com/rust-lang/www.rust-lang.org/issues/new/choose">File an issue!</a> </p> <p>Looking for the <a href="https://prev.rust-lang.org">previous website</a>?</p> </div> </div> </footer> <script src="/static/scripts/languages.js"></script> </body> </html>

CINXE.COM

Learn Rust - Rust Programming Language