Cargo feature 管理:AI 工具不要默认打开所有能力

国科大——形式语言与自动机理论(0812课程)——作业 此次作业题考察,包括但不限于有限自动机、无限自动机、正则文法、正则表达式以及正则语言的性质,题考查下推自动机相关的知识,题考查图灵机相关的知识。此课程建议本科学习过课程的同学选修,成绩占比:考试100%。此课程虽然留有作业,但可做也可不做,且不考勤。 阅读详情

Cargo feature 管理:AI 工具不要默认打开所有能力

刚开始学 Rust 的时候,我对 Cargo.toml 里的 [features] 段几乎没什么概念。需要什么依赖就往 [dependencies] 里加,能用就行。等我的 AI CLI 工具长了几个月,依赖表拉到四十多行——wasmtime、tokio、reqwest、tracing、clap、各种编解码库——每次编译都够我喝完一整杯咖啡。

更糟糕的是,有些用户只想要一个简单的命令行工具,根本不需要 WASM 插件系统。但他们也不得不把整个 wasmtime 编译一遍,下载几百兆的依赖,等好几分钟。那一刻我才理解 Cargo feature 的意义:不是让你创建一百种编译组合,而是让不同用户拿到刚好够用的二进制。

在自学的过程中,我以前的思路是"一个二进制解决所有问题"。但 feature 系统让我学会了克制——默认只打开最需要的能力,其他功能让用户按需开启。

一、先把能力拆开,画出边界

在动手写 feature 之前,我习惯先把项目的组件能力画成一张图:

flowchart TD
    A[核心 CLI Core CLI] --> B{Feature 开关 Features}
    B -->|provider-http| C[远程 HTTP 调用 Remote Provider]
    B -->|provider-local| D[本地模型推理 Local Inference]
    B -->|wasm-plugin| E[WASM 插件系统 Plugin System]
    B -->|tracing| F[日志追踪 Tracing Log]
    B -->|rich-cli| G[彩色输出与进度条 Rich Output]
    
    C -->|依赖 reqwest| C1[reqwest / hyper]
    E -->|依赖 wasmtime| E1[wasmtime]
    F -->|依赖 tracing-subscriber| F1[tracing-subscriber]
    G -->|依赖 indicatif/owo-colors| G1[indicatif]
    
    style A fill:#bbf,stroke:#333,stroke-width:2px
    style C1 fill:#ddd,stroke:#999
    style E1 fill:#ddd,stroke:#999
    style F1 fill:#ddd,stroke:#999
    style G1 fill:#ddd,stroke:#999

核心 CLI 本身应该轻到几乎只有参数解析、配置加载和任务编排。所有"重量级能力"都通过 feature 开关控制。这样普通用户编译时只拿到一个轻量的二进制,高级用户打开对应 feature 就有了完整能力。

二、Cargo.toml 的 feature 配置

下面是一个实际的 feature 配置示例。关键原则是:默认功能要克制,Optional dependency 要跟 feature 绑定,互斥能力要在编译期给清楚错误:

[package]
name = "ai-cli"
version = "0.5.0"
edition = "2021"

[features]
# 默认只打开 HTTP provider,这是最常用的能力
default = ["provider-http"]

# 各个 feature 的定义和关联依赖
provider-http = ["dep:reqwest", "dep:serde_json"]
provider-local = ["dep:candle-core", "dep:tokenizers"]
wasm-plugin = ["dep:wasmtime"]
tracing = ["dep:tracing", "dep:tracing-subscriber"]
rich-cli = ["dep:indicatif", "dep:owo-colors"]

[dependencies]
# 核心依赖(总是编译)
clap = { version = "4", features = ["derive"] }
serde = { version = "1", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

# 可选依赖(由 feature 控制是否参与编译)
reqwest = { version = "0.12", features = ["json"], optional = true }
serde_json = { version = "1", optional = true }
candle-core = { version = "0.6", optional = true }
tokenizers = { version = "0.19", optional = true }
wasmtime = { version = "20", optional = true }
tracing = { version = "0.1", optional = true }
tracing-subscriber = { version = "0.3", optional = true }
indicatif = { version = "0.17", optional = true }
owo-colors = { version = "4", optional = true }

需要注意两个细节:一是用 dep:xxx 语法来在 feature 中引用 optional dependency(这是 Rust 1.60 以后的标准写法);二是不要把 feature 名字起得像"技术债"——provider-http 比 use-reqwest-backend 更好,因为未来你可能换掉 reqwest 但 feature 名不用变。

三、代码里用 cfg 条件编译控制模块

有了 feature 定义,代码里就可以用 #[cfg(feature = "...")] 来控制哪些代码参与编译:

// 将插件系统整个模块挂到 feature 开关下
#[cfg(feature = "wasm-plugin")]
pub mod plugin;

// 初始化日志系统(仅在 tracing feature 开启时可用)
#[cfg(feature = "tracing")]
pub fn init_tracing() {
    tracing_subscriber::fmt()
        .with_env_filter("ai_cli=debug")
        .init();
}

// 无 tracing feature 时提供一个空实现,避免编译错误
#[cfg(not(feature = "tracing"))]
pub fn init_tracing() {
    // 不做任何事
}

/// 根据编译时 feature 选择 Provider 实现
pub fn create_default_provider(config: &Config) -> Box<dyn AiClient> {
    // 注意:这两个 feature 是互斥的,Cargo 会保证只有一个开启
    #[cfg(feature = "provider-http")]
    {
        Box::new(HttpAiClient::new(config))
    }
    #[cfg(feature = "provider-local")]
    {
        Box::new(LocalAiClient::new(config))
    }
}

如果两个 feature 互斥(比如不能同时开启 HTTP 和 Local provider),可以在代码里加编译期检查:

#[cfg(all(feature = "provider-http", feature = "provider-local"))]
compile_error!("provider-http 和 provider-local 不能同时开启,请只选择其中一个");

这样用户在编译时就会看到清晰的错误信息,而不是一百行不知所云的类型推导失败。

四、CI 要测关键 feature 组合

feature 一多,很容易出现"某个冷门组合编译不过"的情况。我给自己定的 CI 最低检查清单是:

# 无默认功能 — 验证核心 CLI 的纯粹性
cargo check --no-default-features

# 默认组合 — 大多数用户的使用方式
cargo check

# 全部功能(如果有互斥则选最大可用集)
cargo check --features "provider-http,wasm-plugin,tracing,rich-cli"

# 本地模型用户组合
cargo check --no-default-features --features "provider-local,rich-cli"

# 测试
cargo test --no-default-features
cargo test

安装文档里也要写清楚不同用户应该用哪个命令:

# 普通用户:默认安装,只需 HTTP provider
cargo install ai-cli

# 插件用户:额外开启 WASM 支持
cargo install ai-cli --features wasm-plugin

# 极简用户:只要核心功能,连 HTTP 都不用
cargo install ai-cli --no-default-features

让用户在安装时就选择能力,比给他们一个 200MB 的二进制然后说"很多功能你不用可以忽略"要好得多。

给个真实数字:我的 CLI 工具默认不开 wasm-plugin 时编译时间大约 15 秒,开启后要 90 秒,二进制体积也从 4MB 涨到 28MB。对只想问个问题的用户来说,多耗的这 75 秒和 24MB 就是不必要的代价。Feature 开关帮我们省下的,不是代码行数,是用户的时间。

还有一点容易被忽略:feature 之间如果有间接依赖,--all-features 可能会引入你根本没想要的 crate。比如只开了 provider-http,但 wasm-plugin 的一个可选依赖悄悄拉进了 wasmtime,编译时间翻倍。建议定期跑 cargo tree --edges features 审计,看看哪些 feature 在污染依赖树。

五、总结

Cargo feature 管理的核心不是"把功能拆得越细越好",而是默认能力要克制,做到"用户需要时才开启"。 核心 CLI 保持极简,重量级功能做成 optional feature,互斥能力在编译期报错,CI 覆盖关键组合。

作为自学者,我以前喜欢"一个二进制打天下"的感觉。但 feature 让我学会了另一种思路:做减法也是一种能力。 少一点默认依赖,编译就快一点,二进制就小一点,供应链风险也少一点。给用户刚好够用的工具,比塞给用户一个万能瑞士军刀更负责任。

SQL面试题——最大连续登陆问题 最大连续登陆是我们计算比较常用的指标,我们可以将其当成一个经典的SQL模型,后面我们也会陆续总结出其他的模型,你还知道其他的比较经典的SQL 吗?欢迎分享,或者你还知道其他的关于计算连续的指标?最大连续登陆重要的是计算思想,最大连续才是关键,登陆只是一个场景,要学会举一反三。 阅读详情

相关推荐

Anaconda镜像源切换全攻略:从清华源到恢复默认设置的完整流程

本文详细介绍了Anaconda镜像源的管理与优化,重点讲解了如何配置清华源以提升国内下载速度。内容涵盖镜像源工作原理、清华源详细配置步骤、多源管理策略、常见问题排查以及如何安全恢复默认设置,帮助用户构建完整的镜像源管理体系。

weixin_28828243的博客 1023

Cargo 工作区依赖治理:版本统一不是复制粘贴

Cargo 工作区依赖治理要使用 workspace dependencies 统一版本,按需开启 feature,并定期检查依赖树。多包项目的稳定性,来自边界和依赖方向。版本统一不是复制粘贴,而是把重复决策收敛到一个地方。

no1coder的博客 2369

华为iTrustee实战:5分钟搞定TrustZone环境搭建(附BoostKit配置技巧)

本文提供了一份华为iTrustee与ARM TrustZone环境的5分钟快速搭建实战指南。详细介绍了在TaiShan服务器上利用鲲鹏BoostKit套件部署可信执行环境(TEE)的完整流程,包括环境检查、驱动安装、首个可信应用(TA)的编译与运行,并分享了关键的BoostKit配置技巧与深度排错方法,助力开发者快速为业务注入硬件级安全能力。

yoga7的博客 968

AI 辅助:Cargo 工作区管理:从单包项目到系统级工具链

Cargo 工作区适合管理中大型 Rust 项目,通过多 crate 拆分核心逻辑、入口、协议和插件。保持依赖方向清晰、共享依赖统一,并避免过早拆分,才能让系统级工具链稳步扩展。

no1coder的博客 1658

基于STM32F407的定时器以及定时器中断的实现

基于STM32F407的定时器以及定时器中断的实现

weixin_57941207的博客 5232

基于结构的虚拟筛选模型 gnina 从源码编译

所需要的软件安装包: 安装 CUDA 装的时候看着点,第二个要你装驱动的选择,回答N,不装。 sudo sh cuda_10.0.130_410.48_linux.run sudo vim ~/.bashrc 在 ~/.bashrc 文件最后加上 export PATH=/usr/bin:/usr/local/cuda-10.0/bin${PATH} export LD_LIBRARY_PATH=/usr/local/cuda-10.0/lib64:${LD_LIBRARY_PATH} source ~

周迪新的博客 3190

RisingWave 的 workspace-config:通过 Cargo Feature 统一机制配置静态链接与编译期日志

`workspace-config` 是 RisingWave 工作区中一个规模极小却作用关键的工具 crate。它不实现任何业务逻辑,而是专门用来"配置某些依赖的特性(features)":一方面为发布构建强制收紧日志级别(编译期日志过滤),另一方面通过 feature 开关控制 zlib、lzma、SASL、OpenSSL、zstd 等第三方 C 库是静态链接还是动态链接。本文将以 [work

gitblog_00526的博客 263

ubuntu18.04美化主题(完整版)

和网上的美化一样,但是我当初跟着博客美化的时候遇到一些问题,按博客的做法无法解决。 所以我自己也写一篇关于ubuntu18.04美化主题的博客。 第一步:安装主题工具:GNOME Tweaks sudo apt-get update sudo apt-get install gnome-tweak-tool 然后安装完成后我们打开Tweaks(截图如下): 第二步,修改窗口按钮位...

B丶atty的博客 7万+

Hunyuan3D-2 实战指南:一张图片 3 步完成 3D 生成

如果你手上只有一张 2D 图片,却需要一个能直接放进游戏或渲染引擎的 3D 模型,靠手工建模、拆 UV、画贴图往往要耗掉好几天。Hunyuan3D-2 是腾讯混元团队开源的高分辨率 3D 生成系统,就是为这类任务设计的:给一张图,它按"先生成形状、再合成纹理"两步产出带贴图的 3D 模型,你自建的网格也能拿来上色。本文按"装环境 → 跑通第一个网格 → 完成完整流程"三个阶段带你从零上手,并在每步

gitblog_00047的博客 436

UG NX二次开发(C#)--详细讲述编程模板NXOpen_CS_Wizard的代码意义,帮你轻松进入NXOpen(C#)二次开发

有几个读者私信问我,在看了“NX1957在VS2019上二次开发的环境配置”后,能完成了UG NX二次开发(C#)模板的配置,也能根据模板创建工程,但是对工程文件.cs不甚理解;并且,在UG Styler新建完成后,其也有一个dlx文件和.cs文件,也不清楚怎么使用。本文先对UG NX二次开发(C#)模板文件进行讲解,在下一个博客中,讲解Styler新建后的模板文件。以上就是对编程模板NXOpen_CS_Wizard(c#)的讲解,其实只要明白了逻辑关系,编程实现只是时间问题,祝你好运。

GimiGimmy 1788

Dify基础:Dify平台的本地化部署(含windows部署中,常见问题及解决方案)

第一种比较简单,只需要在浏览器中,打入https://dify.ai/就可以。这个指令虽然看起来简单,但实际上涉及到对docker的使用。这个项目既然有github地址,那它一般就是开源的。我们点开这个github地址,便能看到dify的私有化部署方式。我们可以看到,还是上面那个图,有个按钮,是指向该项目的Github地址的。第二步:按照dify的github给出的指令,对dify进行安装。第一步:我们把dify下载到自己的电脑(或者服务器)上。这里,我们只考虑第二种方式,也就是私有化部署。

xiezhipu的博客 1万+

Cargo 数据 Schema 设计指南:从 Cargo.toml 到 JSON 消息的演进策略

Cargo 作为 Rust 的包管理器,日常会读写多类面向用户与机器的数据格式:`Cargo.toml` 清单、`Cargo.lock` 锁文件、`.cargo/config.toml` 配置、`cargo metadata` 与 `cargo build --message-format` 的 JSON 输出等。这些格式的字段命名、序列化策略与版本演进方式直接决定了 Cargo 能否在长期兼容的

gitblog_01058的博客 366

5ZCM6ZGrVDllSFLkv6Hmga/ljJbnrqHnkIbns7vnu58= GetFlowDropDown SQL注入

5ZCM6ZGrVDllSFLkv6Hmga/ljJbnrqHnkIbns7vnu58=、eHR/OA一体化智慧云平台、智慧一卡通云平台、行业软件开发与定制、智慧企业管理信息化咨询与项目服务为核心业务的顾问式管理咨询和软件个性定制开发的高科技股份集团公司。同鑫T9eHR信息华管理系统存在SQL注入漏洞,攻击者可通过该漏洞上传shell。关闭互联网暴露面或接口设置访问权限。利用sqlmap进行shell。

iSee857的博客 704

为 Cargo 编写 RFC:从提案到稳定化的全流程与清单设计指南

Cargo 的新功能(新配置项、新清单语法、新命令)几乎都要先经过 RFC 提案,再进入 nightly 不稳定开发,最终稳定化。本文以 Cargo 仓库的贡献者文档 [rfc.md](https://link.gitcode.com/i/953e9b9bf174084b440dc74a21ada7d2) 为主线,完整梳理 RFC 的三阶段流程,并重点展开该文档的核心关切——**当你的提案要新增配

gitblog_00396的博客 672

TMS_WebGMaps_1.9.8.0_Full_Source

TMS_WebGMaps_1.9.8.0_Full_Source 全源码 delphi cbuilder

IMSL CNL 7.0.0 (x86-64)Crack

IMSL CNL 7.0.0 (x86-64)Crack intel的算法库破解文件,这是C++版本的破解文件

iloader 新手指南:iOS 侧载与 SideStore 安装,全程不碰命令行

iloader 是一款免费的 iOS 侧载工具,把证书、配对、签名这些手动活全接管了。跟着本文走一遍,你就能把它装好,并把 SideStore 送进 iPhone,全程不用命令行。 ## 它替你做了什么 自己折腾 iOS 侧载,要自己配开发证书、准备配对文件、给应用做签名,哪一步卡住都得推倒重来。iloader 把这些收进一个向导式界面。你登录 Apple ID,点几下,SideStore 就

gitblog_00508的博客 353

LinePhone3.2.7(android端最新版本) sip客户端

SIP客户端For android:LinePhone3.2.7(最新版本),官网地址:http://www.linphone.org/

Cargo 不稳定特性(Unstable Features)开发全流程:从跟踪 Issue 到稳定化的贡献指南

Cargo 的绝大多数新功能都会先以"不稳定特性"的形式进入 nightly 通道,由用户显式选择开启后收集反馈,最终再通过稳定化流程正式发布。本文以 Cargo 仓库 [doc/contrib/src/process/unstable.md](https://link.gitcode.com/i/d4d419b8baca7b187ce78b71184d7430) 为骨架,结合 [src/work

gitblog_00334的博客 351

visio安装包

Microsoft Office Visio 是一款专业的制图软件。利用经过更新的形状、协作工具和数据链接图表,创建专业级图表以简化复杂的信息。

Folia 全屏歌词动画播放器上手指南:把每首歌唱成满屏文字剧场

Folia 是一个把歌词变成全屏文字动画的音乐播放器,支持网易云、QQ 音乐、酷狗、本地曲库和 Navidrome。你不用先背它的功能表,跟着下面的点法走,几分钟就能让满屏文字跟着节奏动。 ## 第一次打开它 1. 启动后,先看到一面 3D 卡片墙,网易云、QQ、酷狗各占一格。 2. 点进任一平台卡片,直接进搜索页,不用再找入口。 3. 输歌名再点播放,点进去就有声。 4. 标题栏随即自动收起

gitblog_00783的博客 735

cargo-stow 实战:用工作区 Lint 规则治理 Rust Monorepo 的结构与依赖

本指南围绕 baml 仓库内自研的 cargo 子命令 **cargo-stow**([baml_language/crates/tools_stow/README.md](https://link.gitcode.com/i/ef49ea59480d6e23d46fd823a3b4496e))展开,讲解它如何为大型 Rust workspace 提供结构校验、命名规范、依赖约束与依赖图可视化。读

gitblog_01187的博客 205

DeepTutor 实战指南:从装到跑,4 步点亮自托管 AI 学习工作台

同一个问题,问通用聊天机器人,得到一段两千字的教科书式长文;问 DeepTutor,这款自托管的 Agent 原生学习工作台,会先翻你的本地知识库,再带你一步步推,顺手把检验用的习题也出了。从敲下第一条命令到拿到第一份带引用的回答,全程只有 4 步、3 个核心场景。它像你手里那个背得下教材每一页、还能自己出期末卷的助教。 ## 🗺️ 一段话看懂全貌:谁跟谁通信,数据落在哪 浏览器只跟前端端口

gitblog_00482的博客 726

Feature Flags功能特性深度解析

Feature flags是Rust生态系统中最具表现力的设计模式之一,它通过编译时条件编译实现代码的模块化和可选功能。这种机制不仅是技术工具,更体现了Rust"零成本抽象"的哲学——未使用的功能不会产生任何运行时开销。深入理解feature flags的设计原理和应用场景,是构建灵活、可维护库的必备能力。

weixin_62741976的博客 825

Rust Feature Flags:从条件编译到模块化设计的工程哲学

Rust 的 Feature Flags 是一种强大的编译时配置系统,它体现了 Rust "零成本抽象" 和 "显式控制" 的设计哲学。它不仅仅是 `if/else 的编译时版本,更是一种管理依赖、适配平台(如no_std)和控制代码足迹的工程策略。真正的专业性体现在对“加法原则”的坚持和对“特性统一”机制的深刻理解。错误设计的特性会给整个生态系统带来冲突和痛苦;而精心设计的特性则能让库在保持轻量级核心的同时,提供无与伦比的灵活性和可扩展性。

2501_94041669的博客 589

洛雪音乐助手从安装到进阶:免费开源跨平台音乐播放器上手教程

洛雪音乐助手是一款免费、开源、跨平台的桌面音乐播放器,基于 Electron 和 Vue 3 构建,聚合酷我、酷狗、咪咕等多个平台的曲库,Windows、macOS、Linux 都能用。这篇教程按真实使用顺序展开:先帮你判断值不值得装,再带你在三分钟里装好、把第一首歌听顺,之后讲搜索、桌面歌词和快捷键,最后落到排障、数据同步、开放 API 这些进阶内容上。 [![洛雪音乐助手免费开源跨平台音乐播

gitblog_00183的博客 625

Claudia代码贡献指南:参与开源AI工具开发的全流程

Claudia(opcode)是一款强大的Claude Code GUI应用和工具包,允许用户创建自定义代理、管理交互式Claude Code会话、运行安全的后台代理等。本指南将帮助新手开发者快速掌握参与这一开源AI工具项目的完整流程,从环境搭建到代码提交的每一步都清晰明了。 ## 🚀 为什么选择贡献Claudia? 参与Claudia开源项目不仅能提升你的开发技能,还能为AI辅助开发工具的

gitblog_00939的博客 240

coin11-tb新手上路:如何连接Android手机自动完成淘宝双11金币任务

[coin11-tb](https://link.gitcode.com/i/1b055503fe13f4ae528d200740d28905) 是一个基于 `uiautomator2` 的淘宝自动化脚本项目,能帮你把 **Android 手机** 连上电脑后,自动刷 **淘宝双11金币任务、618金币任务、淘金币任务、芭芭农场、闲鱼、支付宝打卡** 等一系列重复性活动,让你彻底告别手动点击。本文

gitblog_00585的博客 242

Rust 模块、Crate 与 Workspace 组织之道:为 Python 开发者定制的代码组织指南(RustTraining python-book 第 8 章)

> **导读**:本文以 RustTraining 仓库中 [python-book/src/ch08-crates-and-modules.md](https://link.gitcode.com/i/2ba09f49ae4124018d4657ae25b79ff7) 为核心骨架,系统对比 Python 与 Rust 的代码组织方式:从 `import`/`__init__.py` 到 `mod

gitblog_00655的博客 812

Xberg 文档智能引擎实战指南:107 种格式统一提取、OCR 与多语言绑定全景解析

Xberg 是一个以 Rust 为核心的多语言文档智能引擎:把任意输入——PDF、扫描图像、电子表格、音频、URL、压缩包乃至整个源码树——交给它,即可一次性获得干净文本、表格、元数据与结构化数据,格式检测、读取、OCR 与提取全部由单一核心完成,无需手动拼接多库管道。本文以仓库根目录 [README.md](https://link.gitcode.com/i/b9a3a7038490a0c23

gitblog_00721的博客 531
上一篇: Rust serde 实战:AI 响应不要直接当字符串用
下一篇: Rust 流式输出:让模型边生成边显示,但别忘了中断
第一程序员
博客等级 码龄1年 1万+粉丝 1822原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值