如何在IntelliJ IDEA/WebStorm中排除文件夹索引但不阻止Git跟踪？

解决方案 #

可通过以下两种方案解决WebStorm排除dist索引和Git自动暂存的冲突问题，根据实际需求选择即可：

方案一：仅排除dist目录参与代码统计（最优选择） #

不需要将整个dist目录标记为排除，仅配置WebStorm的统计范围过滤dist即可，完全不影响IDE对dist目录的文件监听和Git自动暂存逻辑，操作步骤如下：

• 打开WebStorm设置面板：File > Settings（macOS为 WebStorm > Settings）
• 依次进入 Appearance & Behavior > Scopes，点击「+」选择「Local」新建自定义范围，命名可设为 ExcludeDistFromStats
• 在范围配置的「Pattern」输入框中填入规则：!file:dist//*，该规则代表匹配时排除所有dist目录下的文件，保存配置
• 进入代码统计相关配置页：新版WebStorm路径为 Editor > Code Editing > Code Vision > Code Metrics，旧版本可搜索「Statistics」找到统计范围配置项，将统计范围选择为你刚创建的自定义范围即可。

方案二：保留dist目录索引排除配置，通过Git钩子自动暂存dist文件 #

如果你除了避免代码重复统计外，还希望dist目录不参与代码搜索、补全等索引操作，可以保留dist的「Excluded」标记，通过Git pre-commit钩子实现dist变更自动暂存，无需手动操作：

• 进入项目根目录下的 .git/hooks 文件夹，找到名为 pre-commit.sample 的文件，重命名为 pre-commit（无后缀）
• 打开pre-commit文件，清空原有示例内容，添加以下代码：

#!/bin/sh
# 自动暂存dist目录所有变更
git add dist/

• 给该文件添加可执行权限：
  • macOS/Linux系统：在终端执行 chmod +x .git/hooks/pre-commit
  • Windows系统：打开Git Bash，进入项目目录执行上述命令即可

配置完成后，每次执行commit操作时Git都会自动暂存dist目录的所有变更，不会出现漏加文件导致部署失败的问题。

注意事项 #

• 需确保项目根目录的 .gitignore 文件中没有添加 /dist/ 忽略规则，否则Git会直接跳过该目录的检测，上述配置无法生效
• Parcel构建后生成的带哈希的旧文件如果需要清理，可以在构建命令前添加删除dist目录的逻辑，比如将package.json中的build命令改为 rm -rf dist && parcel build，避免旧文件残留在dist中。

内容的提问来源于stack exchange，提问作者Benedict Lang