htmlq 版本升级指南：从 0.3.x 迁移到 0.4.0 的注意事项
【免费下载链接】htmlq Like jq, but for HTML. 
项目地址: https://gitcode.com/gh_mirrors/ht/htmlq
你是否在使用 htmlq 0.3.x 版本时遇到过命令行参数混乱、输出格式不统一的问题？本文将详细介绍从 0.3.x 版本迁移到 0.4.0 版本的关键变化和操作步骤，帮助你平稳完成升级。读完本文后，你将了解版本间的核心差异、迁移步骤以及常见问题的解决方案。
版本核心变化概述
0.4.0 版本是 htmlq 的一次重要更新，主要聚焦于提升用户体验和命令行参数的规范性。通过分析 Cargo.toml 和 src/main.rs，我们发现以下关键变化：
参数重命名与功能调整
| 0.3.x 参数 | 0.4.0 参数 | 功能变化 |
|---|---|---|
--ignore-whitespace | -w, --ignore-whitespace | 保持功能不变，短选项从无变为 -w |
--pretty-print | -p, --pretty | 参数简化，功能不变 |
--text-content | -t, --text | 参数重命名，功能保持一致 |
新增 -B, --detect-base | 新增功能，自动检测 HTML 中的 <base> 标签 |
依赖项更新
在 Cargo.toml 中可以看到，主要依赖项进行了版本升级：
kuchiki从 0.7.x 升级到 0.8.1html5ever从 0.24.x 升级到 0.25.1clap保持 2.33.3 版本，但参数解析逻辑有调整
详细迁移步骤
1. 安装新版本
通过 Cargo 安装最新版本：
cargo install htmlq --version 0.4.0
如果你使用其他包管理器，可以参考 README.md 中的安装指南，其中提供了 FreeBSD pkg、Homebrew 和 Scoop 等多种安装方式。
2. 命令行参数调整
文本内容提取
旧版本 (0.3.x)：
curl example.com | htmlq --text-content .main
新版本 (0.4.0)：
curl example.com | htmlq -t .main
格式化输出
旧版本 (0.3.x)：
htmlq --pretty-print '#content' < index.html
新版本 (0.4.0)：
htmlq -p '#content' < index.html
3. 新增功能应用
自动检测基础 URL
0.4.0 版本新增了 -B, --detect-base 参数，可自动从 HTML 文档的 <base> 标签中提取基础 URL，结合 -b 参数使用效果更佳：
curl example.com | htmlq -B -b https://example.com --attribute href a
节点移除功能增强
通过 --remove-nodes 参数可以在输出前移除指定节点，在 0.4.0 版本中支持多次指定：
curl example.com | htmlq .content --remove-nodes script --remove-nodes style
常见问题解决方案
问题：编译时报依赖错误
解决方案： 删除旧的依赖缓存并重新安装：
cargo clean
cargo install htmlq --version 0.4.0
问题：旧脚本中参数无法识别
解决方案： 使用 grep 和 sed 批量替换脚本中的旧参数：
grep -rl -- '--text-content' ./scripts | xargs sed -i 's/--text-content/-t/g'
测试与验证
为确保升级后功能正常，建议运行 tests/cli.rs 中的测试用例：
cargo test
测试将验证所有核心功能是否正常工作，包括选择器解析、属性提取和文本内容输出等。
总结与展望
0.4.0 版本通过规范化命令行参数和增强功能，显著提升了 htmlq 的易用性。主要改进包括参数简化、新增基础 URL 自动检测和节点移除增强。如果你在迁移过程中遇到任何问题，可以查阅 README.md 或提交 issue 寻求帮助。
未来版本将继续优化性能和增加新功能，敬请期待。
【免费下载链接】htmlq Like jq, but for HTML. 项目地址: https://gitcode.com/gh_mirrors/ht/htmlq
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
