Code2Prompt项目v2.x版本中--exclude参数的正确使用方法

在Code2Prompt项目从v1.x升级到v2.x版本后，许多用户发现--exclude参数的行为发生了变化，导致预期的文件排除功能失效。本文将深入分析这个问题，并提供正确的使用方法。

问题现象

用户在使用类似以下命令时：

code2prompt ./ --exclude="vendor,node_modules,build,composer.lock,package-lock.json,code2prompt.md" --exclude-from-tree --output=code2prompt.md

发现所有被排除的文件仍然被包含在输出中，这与v1.x版本的行为不符。

原因分析

在Code2Prompt v2.x版本中，文件排除机制采用了glob模式匹配规则，这与v1.x版本的简单字符串匹配有本质区别。用户常见的错误包括：

1. 使用逗号分隔多个排除模式（v1.x方式）
2. 没有使用正确的glob语法
3. 忽略了目录匹配的特殊性

正确使用方法

基本语法

正确的排除语法应该是：

code2prompt <路径> --exclude "模式1" --exclude "模式2"

常见排除场景示例

1. 排除特定目录：

   --exclude "**/node_modules/**"
   

2. 排除特定文件类型：

   --exclude "**/*.lock"
   

3. 排除特定文件：

   --exclude "**/package-lock.json"
   

4. 多模式排除：

   --exclude "**/vendor/**" --exclude "**/build/**" --exclude "**/*.lock"
   

技术原理

Code2Prompt v2.x使用Node.js的glob模式匹配规则，其中：

• ** 匹配任意深度的目录
• * 匹配除路径分隔符外的任意字符
• ? 匹配单个字符

这种设计提供了更强大和灵活的文件匹配能力，但也需要用户适应新的语法规则。

最佳实践

1. 对于目录排除，始终使用**/目录名/**格式
2. 对于特定文件，使用完整路径模式**/文件名
3. 避免在单个--exclude参数中包含多个模式
4. 测试排除效果时，可以先在小范围目录中验证

总结

Code2Prompt v2.x版本的--exclude参数虽然需要学习新的语法规则，但提供了更精确的文件控制能力。理解并正确使用glob模式，可以有效地管理项目文件的包含与排除，提高代码提示的准确性和效率。