如何在Raku项目中使用本地自定义模块？编译时如何关联？

一、解决模块找不到的问题 #

同一目录下模块加载失败，核心是Raku没找到你的模块文件路径，不用发布就能解决，试试这几种方法：

• 用lib目录统一存放模块
  Raku默认会检索当前目录下的lib子目录。把你的.rakumod文件放到lib/MyProject/路径下（比如lib/MyProject/OtherModule.rakumod），主脚本或模块放在根目录，直接写use MyProject::OtherModule;就能正常加载。

• 运行时指定模块路径
  如果不想动目录结构，运行脚本时用-I参数把当前目录加入搜索路径：

  raku -I. your-main-script.raku
  

• 代码里指定搜索路径
  在主模块或脚本开头加一行use lib '.';，把当前目录加入模块搜索路径，再加载目标模块：

  use lib '.';
  use MyProject::OtherModule;
  

二、是否需要每次运行都发布模块？ #

完全不需要。发布模块是为了上传到CPAN这类公共仓库供他人使用，本地开发只要让Raku能找到模块文件路径就行，上面的方法都能搞定本地加载问题，没必要发布。

三、大型Raku项目架构建议 #

• 遵循标准目录结构
  社区通用的结构能让项目更清晰，核心模块放lib，测试代码放t，可执行脚本放bin，示例结构如下：

  MyProject/
  ├── lib/
  │   └── MyProject/
  │       ├── Core.rakumod
  │       ├── Utils.rakumod
  │       └── API/
  │           └── Auth.rakumod
  ├── t/
  │   ├── core.t
  │   ├── utils.t
  │   └── api-auth.t
  ├── bin/
  │   └── project-cli.raku
  └── META6.json
  

• 用META6.json管理项目
  哪怕本地开发，创建META6.json能统一管理项目的依赖、模块映射信息，后续要发布也更顺畅。简单示例：

  {
    "name": "MyProject",
    "version": "0.0.1",
    "author": "Your Name",
    "description": "A large-scale Raku project",
    "depends": [],
    "provides": {
      "MyProject::OtherModule": "lib/MyProject/OtherModule.rakumod"
    }
  }
  

• 按职责拆分模块
  别把所有代码堆在一个文件里，按功能或领域拆分：比如MyProject::Core处理核心业务逻辑，MyProject::Utils放通用工具函数，MyProject::API负责接口交互，每个模块只做一件事。

• 配套测试代码
  大型项目离不开测试，t目录下的测试文件能帮你验证模块功能，运行测试用raku -Ilib t/xxx.t即可，长期维护代码时测试是可靠性的保障。

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