在需要验证 Rust Cargo.toml 清单的依赖问题、缺失元数据、功能冲突、工作区配置以及 crates.io 发布准备情况时使用。
货物.toml验证器
功能概述
货物.toml验证器是一项面向实际任务的技能，主要用于Validate Rust Cargo.toml 显示文件的结构正确性、依赖性卫生、特性配置、工作空间设置和箱.io发布准备。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
- 从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
Cargo.toml 验证器
验证 Rust Cargo.toml 清单文件的结构正确性、依赖健康度、功能（feature）配置、工作区（workspace）设置，以及是否符合 crates.io 发布要求。使用 Python 3.11+ 内置的 tomllib 进行原生 TOML 解析 —— 无需任何外部依赖。
命令
validate — 执行完整验证（启用全部规则）
python3 scripts/cargo_toml_validator.py validate Cargo.toml python3 scripts/cargo_toml_validator.py validate Cargo.toml --strict python3 scripts/cargo_toml_validator.py validate Cargo.toml --format json
check — 快速检查（仅报告错误与警告）
python3 scripts/cargo_toml_validator.py check Cargo.toml python3 scripts/cargo_toml_validator.py check Cargo.toml --format summary
explain — 列出所有规则及其说明
python3 scripts/cargo_toml_validator.py explain Cargo.toml python3 scripts/cargo_toml_validator.py explain Cargo.toml --format json
suggest — 执行验证并提出修复建议
python3 scripts/cargo_toml_validator.py suggest Cargo.toml python3 scripts/cargo_toml_validator.py suggest Cargo.toml --format json
标志（Flags）
| 标志 | 说明 |
|---|---|
--strict |
将警告视为错误 — 返回退出码 1（适用于 CI 环境） |
--format text |
人类可读格式输出（默认） |
--format json |
机器可读的 JSON 格式输出 |
--format summary |
精简摘要格式（含各类问题数量统计） |
验证规则（共 24 条）
结构（5 条）
| 规则 | 严重程度 | 说明 |
|---|---|---|
| S1 | error | 文件未找到或不可读 |
| S2 | error | 空文件 |
| S3 | error | TOML 语法无效 |
| S4 | error/warning | 缺少 [package] 区块（对二进制/库项目为 error；对虚拟工作区为 warning） |
| S5 | error/warning | 缺少必需字段：name、version（error），edition（warning） |
包元数据（4 条）
| 规则 | 严重程度 | 说明 |
|---|---|---|
| M1 | warning | 缺少 edition 字段（默认为 2015） |
| M2 | info | 使用的 edition 已过时（2015/2018，而 2021/2024 可用） |
| M3 | warning | 未指定 license 或 license-file（影响 crates.io 发布） |
| M4 | warning | 未指定 description（影响 crates.io 发布） |
依赖（6 条）
| 规则 | 严重程度 | 说明 |
|---|---|---|
| D1 | error | 使用通配符版本号 * |
| D2 | warning | 未锁定版本的依赖（无版本限定符） |
| D3 | warning | Git 依赖未通过 rev/tag/branch 显式锁定 |
| D4 | info | 路径依赖（path dependency）—— 将阻断 crates.io 发布 |
| D5 | warning | 同一依赖同时出现在 [dependencies] 和 [dev-dependencies] 中，且版本不一致 |
| D6 | info | 使用了已弃用的 crate 名称（如 failure、error-chain、iron、rustc-serialize，以及旧版 hyper/tokio/actix-web/rocket/time） |
功能（Feature）（3 条）
| 规则 | 严重程度 | 说明 |
|---|---|---|
| F1 | error | Feature 启用了不存在的依赖项 |
| F2 | warning | 空 Feature（不含依赖项或子 Feature） |
| F3 | error | Feature 存在循环依赖 |
工作区（Workspace）（3 条）
| 规则 | 严重程度 | 说明 |
|---|---|---|
| W1 | warning | [workspace] 区块未定义 members |
| W2 | info | 同时存在 [package] 和无 members 的 [workspace]（语义模糊） |
| W3 | info | 检测到 [workspace.dependencies] — 提示成员应设置 workspace = true |
最佳实践（3+ 条）
| 规则 | 严重程度 | 说明 |
|---|---|---|
| B1 | info | 已发布 crate 缺少文档链接（documentation 字段） |
| B2 | info | 存在构建脚本（build script），但未声明 [build-dependencies] |
| B3 | info | 依赖数量过多（>30 个） |
| B4 | info | 缺少仓库（repository）或主页（homepage）URL |
退出码（Exit Codes）
| 码值 | 含义 |
|---|---|
| 0 | 无错误（允许存在警告，除非启用 --strict） |
| 1 | 发现错误（或在 --strict 模式下出现警告） |
| 2 | 文件未找到 / 解析失败 |
输出示例
Cargo.toml validate — Cargo.toml
=================================
[ERROR ] S5: Missing required field: package.version
Set version directly or use version.workspace = true.
[WARNING] M1: Missing edition field — defaults to 2015
Add edition = "2021" or edition = "2024" to [package].
[WARNING] D3: Git dependency 'my-fork' in [dependencies] is not pinned
Pin to a rev, tag, or branch for reproducibility. URL: https://github.com/user/fork
[INFO ] D4: Path dependency 'utils' in [dependencies] — blocks crates.io publish
Path: ../utils. Fine for local dev, but won't work on crates.io.
[INFO ] B4: Missing repository and homepage URL
Add repository = "https://github.com/..." to [package] for crates.io visibility.
Result: INVALID
Summary: 1 error(s), 2 warning(s), 2 info
热门AI工具
相关专题
本专题从实际API接口调试场景出发，讲解Postman身份认证的完整配置流程，包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查，帮助用户正确完成接口授权与访问验证。
0
2026.11.06
围绕Postman HTTP请求头配置展开，讲解Headers选项的具体使用方式，包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法，帮助用户解决接口调试过程中遇到的请求头配置问题。
0
2026.11.06
详细介绍Postman接口请求的创建与发送方法，涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看，帮助用户掌握Postman接口请求的完整操作流程。
0
2026.11.06
DBeaver数据导入专题，整理Excel、CSV、SQL、TXT等常见文件的数据导入方法，涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作，帮助用户将本地文件中的数据写入数据库，并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。
0
2026.11.05
DBeaver安全防护专题，围绕数据库连接安全、账号密码保护和访问权限管理展开，整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法，同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项，帮助用户提高数据库日常管理的安全性。
0
2026.11.05
本专题聚焦DBeaver数据库连接配置与管理，覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库，整理相应的连接设置方法，并提供驱动缺失、认证失败和连接异常等问题的排查方向。
0
2026.11.04
本专题围绕XORM框架的结构体映射展开，说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充，并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节，拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择，讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式，并补充容器与兼容数据库的适配经验。
0
2026.11.04
本专题聚焦XORM框架的配置与连接环节，拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择，讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式，并补充容器与兼容数据库的适配经验。
0
2026.11.04
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.8万人学习
共6课时 | 54.7万人学习
最新文章
