stack创建Haskell项目运行GHCi出现模块重复定义警告及清理方法咨询

自动生成模块路径冲突警告的成因 #

这不是操作失误导致的，是Stack/Cabal构建体系的固有设计特性：

• Cabal 构建系统会为每一个独立的构建目标（库、可执行文件、测试套件、性能基准）单独生成专属的autogen目录，每个目录下都会生成一份Paths_<当前包名>模块。这个模块是自动产出的元数据文件，作用是让业务代码可以直接读取项目版本号、安装路径、关联资源位置等构建期常量，模块名固定为Paths_primo，但因为分属不同构建目标的独立编译上下文，正常编译流程下不会产生真实的模块冲突。
• 启动stack ghci时默认会将项目下所有构建目标的源文件搜索路径一次性传递给GHCi，模块解析器在扫描搜索路径时，会在不同路径下找到同名的Paths_primo文件，因此弹出“存在多个文件使用相同模块名”的提示；同理出现的module ‘main:Main’ is defined in multiple files提示也是同一逻辑下的假阳性——因为搜索路径重叠触发的提示，并不是真的存在两个定义Main模块的业务文件。
• 这类提示不会影响实际编译流程，观察到业务模块全部加载成功的结果，也能证明该警告无实际破坏性。如果要彻底减少这类提示，可以在启动stack ghci时指定需要加载的构建目标，例如stack ghci primo:lib或stack ghci primo-exe，避免一次性加载全部目标的搜索路径，自然就不会触发同名文件的扫描提示。

Stack项目全量重置的正确操作 #

全量重置的核心是清除所有本地构建产物，保留自定义项目配置，具体操作边界如下：

• 可以直接删除的内容，对应你提到的清理操作完全正确：
  • 整个.stack-work目录：这是Stack用来存放编译缓存、自动生成的构建文件、依赖编译产物的专属目录，删除后所有本地构建状态会被清空，下次构建时会从头生成对应的autogen文件、重新编译依赖，是全量重置的核心操作。
  • 自动生成的.cabal文件：如果项目是基于package.yaml做配置管理，这个文件是Stack根据package.yaml内容自动生成的中间产物，删除后无任何副作用，下次构建时会自动重新生成。
• 不建议随意删除的配置文件：
  • stack.yaml：这是手动维护的Stack项目配置，包含选定的GHC版本、依赖解析规则、自定义源路径、构建目标配置等内容，全量重置如果不涉及调整项目基础配置，完全不需要删除该文件。
  • stack.yaml.lock：这是Stack首次解析依赖时生成的锁定文件，记录了当前项目所有依赖包的精确版本、源码位置。如果删除该文件，下次构建时Stack会重新拉取最新可用的依赖版本，可能引入版本不兼容的问题——除非刻意要升级全量依赖、重新做全局版本解析，否则保留该文件即可。

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