如何生成适合项目的 `.gitignore` 文件

选择受支持的语言名称即可生成对应的预设 .gitignore 文本；不填写语言时，工具按 Python 处理。

概览说明，不在此处展开操作步骤。

这个工具用于生成预设的 .gitignore 文本，适合在创建或整理 Git 项目时，先按项目所用语言取得一份对应的忽略规则。当前可选的模板面向 Python、Node、Java、Go 和 Rust；它不是按任意框架或自定义技术栈生成规则的工具。

操作步骤，不在此处重复限制或示例。

1. 打开工具后，在语言输入位置填写项目使用的语言名称。可填写 Python、Node、Java、Go 或 Rust，大小写不会影响已支持语言的匹配。若不填写语言，工具会按 Python 处理，因此适合 Python 项目直接使用默认选项。

2. 确认输入是字符串形式的语言名称，再提交生成操作。若填写的字符串不对应这五种预设模板，结果会失败并返回错误。不要把数字、列表或其他非字符串值当作语言名称提交，因为处理这类输入时可能直接引发异常，而不是返回带错误信息的失败结果。

3. 查看生成结果中的 .gitignore 文本，并将其复制到项目根目录下名为 .gitignore 的文件中，再根据项目实际使用的工具检查和调整内容。工具提供的是预设文本，不能替代对项目文件结构的人工核对。

如何理解结果，不在此处重复完整流程。

成功时，结果包含所选语言对应的预设 .gitignore 模板文本，以及该文本中的换行符数量。换行符数量可以帮助你确认返回结果包含怎样的文本规模，但它不表示规则已经覆盖项目中的每一种工具或文件类型。

如果结果失败并带有错误，先检查语言字符串是否拼写为受支持的名称；不要仅靠改变大小写来解决未知语言问题，因为大小写本身不影响匹配。对于非字符串输入，应改为提交语言名称字符串。生成结果还需要结合项目实际情况审阅，例如项目同时使用多种语言或额外工具时，可能需要手动补充忽略规则。

使用示例

一个 Node 项目需要先创建基础 .gitignore 文件，用户选择 Node 语言并提交生成操作。

在语言输入位置提交字符串“Node”，然后查看生成结果中的文本和换行符数量。

结果包含对应的 Node .gitignore 预设文本，以及该文本中的换行符数量。

使用限制

• 工具只提供五种预设语言模板，不能据此推断对其他语言、框架或项目组合提供模板，也不能保证预设内容适合每个项目。

常见错误

• 原因：输入了不属于 Python、Node、Java、Go 或 Rust 的语言字符串。处理：改用这五种受支持名称之一，并再次提交。

常见问题

不填写语言会生成哪种 .gitignore 模板？

不填写语言时，工具会使用 Python 模板；填写语言时，应使用 Python、Node、Java、Go 或 Rust 之一。

语言名称可以使用大写或小写吗？

可以，字符串形式的语言名称会按不区分大小写的方式匹配，因此大小写变化不会改变受支持语言的选择。

输入不支持的语言或非字符串值会怎样？

如果输入是未知语言字符串，结果会失败并带有错误；如果输入不是字符串，处理时可能引发异常。应先改用受支持的语言名称字符串。