Elixir中使用Mixin时如何隐藏拆分出的私有子函数？

你遇到的问题很典型：把Mixin里的长函数拆分成子函数后，这些子函数会被注入到使用模块的顶级作用域，导致模块内的其他函数能意外访问，甚至可能因为同名函数引发冲突。下面是几种优雅的解决办法：

1. 使用匿名函数闭包（最简洁的隔离方式） #

把拆分的子函数定义为long_function内部的匿名函数，这样它们只会在该函数的作用域内存在，完全不会暴露给模块的其他部分：

defmodule Mixin do
  @callback cb(any(), any(), any()) :: any()
  defmacro __using__(_) do
    quote do
      def long_function do
        # 定义仅在long_function内部可见的子函数
        subfunction_1 = fn ->
          # some code
          cb(a, b, c)
        end

        subfunction_2 = fn ->
          # some code
          cb(a, b, c)
          # some code
        end

        # 调用子函数
        subfunction_1.()
        subfunction_2.()
      end
    end
  end
end

优点：完全隔离，不会污染使用模块的命名空间，实现简单。
缺点：子函数之间如果需要共享状态，需要显式传递参数；复杂逻辑下，匿名函数的可读性不如命名函数。

2. 使用嵌套私有模块（结构化隔离） #

在__using__的quote中定义一个嵌套的辅助模块，把拆分的子函数放在这个模块里，同时通过一个私有函数让辅助模块能调用当前模块的回调：

defmodule Mixin do
  @callback cb(any(), any(), any()) :: any()
  defmacro __using__(_) do
    quote do
      def long_function do
        Helpers.subfunction_1()
        Helpers.subfunction_2()
      end

      # 私有函数，让嵌套模块能获取当前模块的引用
      defp module, do: __MODULE__

      # 嵌套辅助模块，默认仅在当前模块内可见（可通过@moduledoc false隐藏文档）
      @moduledoc false
      defmodule Helpers do
        def subfunction_1 do
          # some code
          module().cb(a, b, c)
        end

        def subfunction_2 do
          # some code
          module().cb(a, b, c)
          # some code
        end
      end
    end
  end
end

优点：子函数结构清晰，便于维护和互相调用；不会污染使用模块的顶级命名空间。
缺点：嵌套模块仍然存在于使用模块的结构中（虽然一般不会被意外访问），需要额外定义module()函数来传递模块引用。

3. 将辅助函数放在Mixin本身（完全解耦） #

把拆分的子函数直接定义在Mixin模块里，通过传递当前模块引用的方式调用回调，这样辅助函数完全不会注入到使用模块中：

defmodule Mixin do
  @callback cb(any(), any(), any()) :: any()

  # Mixin内部的辅助函数，接收模块引用作为参数
  defp subfunction_1(module) do
    # some code
    module.cb(a, b, c)
  end

  defp subfunction_2(module) do
    # some code
    module.cb(a, b, c)
    # some code
  end

  defmacro __using__(_) do
    quote do
      def long_function do
        # 调用Mixin的辅助函数，传递当前模块引用
        Mixin.subfunction_1(__MODULE__)
        Mixin.subfunction_2(__MODULE__)
      end
    end
  end
end

优点：辅助函数集中在Mixin中，便于统一维护；完全避免了对使用模块的命名空间污染；回调调用逻辑明确。
缺点：需要传递模块引用，但这是Elixir中跨模块调用回调的常规模式，其实非常清晰优雅。

总结 #

如果只是简单拆分逻辑，优先选择匿名函数闭包；如果子函数较多、逻辑复杂，用嵌套私有模块更合适；如果希望辅助函数完全独立于使用模块，Mixin内部辅助函数是最佳选择。这三种方案都能解决你遇到的子函数暴露和命名冲突问题。

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