南通网站设计哈尔滨seo公司
55-包的声明
包的介绍
当项目规模持续扩张，在单个超大文件里管理源代码，就如同在杂乱无章的巨大仓库找一件小物品，难度极大。此时，将源代码依
据功能进行分组，不同功能的代码分开管理是个很好的解决办法。每组独立管理的代码最终会生成一个输出文件。实际使用时，导
入对应的输出文件，就能调用相应功能，或者通过不同功能间的交互、组合，实现更复杂的特性，极大提升项目管理的效率。
在仓颉编程语言里，包堪称编译的最小单元。每个包都能单独输出AST文件、静态库文件、动态库文件等成果。每个包都有专属的
名字空间，在同一个包内，除了函数重载的情况，不允许出现同名的顶层定义或声明。一个包中还能容纳多个源文件。 模块则是若
干包的集合，它是第三方开发者发布的最小单元。
一个模块的程序入口位置限定在其根目录下，且顶层最多只能有一个用作程序入口的main 。这个main要么没有参数，要么参数
类型为Array<String> ，返回类型为整数类型或者Unit 类型。
包的声明
在仓颉编程语言中，包声明以关键字 package 开头，后接 root 包至当前包由 . 分隔路径上所有包的包名。包名必须是合法的普通标识符（不含原始标识符）。例如：
package pkg1 // root 包 pkg1
package pkg1.sub1 // root 包 pkg1 的子包 sub1
包声明必须在源文件的非空非注释的首行，且同一个包中的不同源文件的包声明必须保持一致。
// file 1
// Comments are accepted
package test
// declarations...// file 2
let a = 1 // Error, package declaration must appear first in a file
package test
// declarations...
仓颉的包名需反映当前源文件相对于项目源码根目录 src 的路径，并将其中的路径分隔符替换为小数点。例如包的源代码位于 src/directory_0/directory_1 下，root 包名为 pkg 则其源代码中的包声明应为 package pkg.directory_0.directory_1。
需要注意的是：
- 包所在的文件夹名必须与包名一致。
- 源码根目录默认名为
src。 - 源码根目录下的包可以没有包声明，此时编译器将默认为其指定包名
default。
假设源代码目录结构如下：
// The directory structure is as follows:
src
`-- directory_0|-- directory_1| |-- a.cj| `-- b.cj`-- c.cj
`-- main.cj
则 a.cj、b.cj、c.cj、main.cj 中的包声明可以为:
// a.cj
// in file a.cj, the declared package name must correspond to relative path directory_0/directory_1.package default.directory_0.directory_1
// b.cj
// in file b.cj, the declared package name must correspond to relative path directory_0/directory_1.package default.directory_0.directory_1
// c.cj
// in file c.cj, the declared package name must correspond to relative path directory_0.package default.directory_0
// main.cj
// file main.cj is in the module root directory and may omit package declaration.main() {return 0
}
另外，包声明不能引起命名冲突：子包不能和当前包的顶层声明同名。
以下是一些错误示例：
// a.cj
package a
public class B { // Error, 'B' is conflicted with sub-package 'a.B'public static func f() {}
}// b.cj
package a.B
public func f {}// main.cj
import a.B // ambiguous use of 'a.B'main() {a.B.f()return 0
}