curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

rustc --version
# rustc 1.XX.0 (xxxxxxx YYYY-MM-DD)

cargo --version
# cargo 1.XX.0 (xxxxxxx YYYY-MM-DD)

rustup --version
# rustup 1.XX.0 (xxxxxxx YYYY-MM-DD)

# 安装不同版本
rustup install stable
rustup install beta
rustup install nightly

# 查看已安装的工具链
rustup toolchain list

# 切换默认版本
rustup default nightly

# 为某个项目固定版本（在项目目录下）
rustup override set stable

# ~/.cargo/config.toml

[build]
# 使用国内镜像加速编译（利用 sccache）
# rustflags = ["-C", "link-arg=-fuse-ld=lld"]  # 使用 lld 加速链接

[net]
# 设置网络超时（秒）
git-fetch-with-cli = true

[registries.crates-io]
# 使用国内镜像（推荐）
protocol = "sparse"

[source.crates-io]
replace-with = "ustc"  # 使用中科大镜像

[source.ustc]
registry = "sparse+https://mirrors.ustc.edu.cn/crates.io-index/"

# 或者使用字节跳动镜像
# [source.rsproxy]
# registry = "sparse+https://rsproxy.cn/crates.io-index/"

# Cargo 二进制目录
export PATH="$HOME/.cargo/bin:$PATH"

{
    "rust-analyzer.check.command": "clippy",
    "rust-analyzer.cargo.features": "all",
    "rust-analyzer.inlayHints.chainingHints.enable": true,
    "rust-analyzer.inlayHints.typeHints.enable": true,
    "rust-analyzer.inlayHints.parameterHints.enable": true,
    "editor.formatOnSave": true,
    "[rust]": {
        "editor.defaultFormatter": "rust-lang.rust-analyzer"
    }
}

-- Neovim LSP 配置示例（使用 lspconfig）
local lspconfig = require('lspconfig')
lspconfig.rust_analyzer.setup({
    settings = {
        ['rust-analyzer'] = {
            checkOnSave = {
                command = 'clippy',
            },
        },
    },
})

{
    // 检查命令：使用 clippy 代替默认的 cargo check
    "rust-analyzer.check.command": "clippy",

    // 启用所有 cargo features
    "rust-analyzer.cargo.features": "all",

    // 链式调用的类型提示
    "rust-analyzer.inlayHints.chainingHints.enable": true,

    // 类型注解提示
    "rust-analyzer.inlayHints.typeHints.enable": true,

    // 参数名提示
    "rust-analyzer.inlayHints.parameterHints.enable": true,

    // 保存时自动格式化
    "editor.formatOnSave": true,

    // proc-macro 支持
    "rust-analyzer.procMacro.enable": true
}

# 创建新项目
cargo new test_env
cd test_env

# 编译并运行
cargo run

# 运行 clippy 检查
cargo clippy

# 格式化代码
cargo fmt

# 运行测试
cargo test

# 使用 mold 链接器（Linux）
# 安装 mold: sudo apt install mold 或从源码编译
# 在 .cargo/config.toml 中配置：
[target.x86_64-unknown-linux-gnu]
rustflags = ["-C", "link-arg=-fuse-ld=mold"]

# 或使用 lld
[target.x86_64-unknown-linux-gnu]
rustflags = ["-C", "link-arg=-fuse-ld=lld"]

# 启用增量编译（默认开启）
export CARGO_INCREMENTAL=1

# 使用 sccache 缓存编译结果
cargo install sccache
export RUSTC_WRAPPER=sccache

# 检查网络配置
cargo config get net

# 使用镜像源（见 2.2 节）

# 使用 git 命令代替 libgit2
export CARGO_NET_GIT_FETCH_WITH_CLI=true

# 确认 rust-analyzer 已安装
rustup component list | grep rust-analyzer

# 手动安装
rustup component add rust-analyzer

# 在 VS Code 中重启语言服务器
# Ctrl+Shift+P → "rust-analyzer: Restart server"