C3语言编译器(c3c)构建输出路径解析

构建命令与输出路径

C3语言编译器(c3c)提供了多种构建命令，每种命令对应不同的构建场景和输出行为。理解这些命令的区别对于开发者正确使用编译器至关重要。

主要构建命令

1. compile命令：用于直接编译单个或多个源文件，不需要项目配置文件。例如：

   c3c compile foo.c3 bar.c3
   

   该命令会将编译结果输出到当前工作目录。

2. build命令：用于构建整个项目，需要项目配置文件(project.json)。例如：

   c3c build
   

   默认情况下，该命令会将最终可执行文件输出到与project.json相同的目录中。

3. compile-run命令：编译并立即运行指定的源文件。

4. run命令：构建项目并立即运行生成的可执行文件。

构建输出路径解析

在C3语言项目中，构建系统会创建两个主要输出位置：

1. 最终可执行文件：默认情况下，build命令生成的可执行文件会被放置在项目根目录(即包含project.json的目录)中。这是设计上的有意行为，因为最终可执行文件通常需要与项目资源文件保持在同一目录层级。

2. build目录：该目录主要用于存放中间构建产物，如对象文件、临时文件等。这些文件通常不需要开发者直接操作，而是由构建系统内部管理。

最佳实践建议

1. 对于项目开发，建议始终使用build命令而非compile命令，因为前者能正确处理项目配置和依赖关系。

2. 如果需要修改默认输出路径，可以在project.json配置文件中指定自定义输出目录。

3. 理解build目录的用途可以避免对中间产物的误操作，这些文件通常会在clean操作时被自动清理。

4. 对于简单的单文件测试，可以使用compile命令快速验证代码逻辑，但要注意其输出位置与项目构建不同。

通过正确理解C3编译器的构建机制，开发者可以更高效地管理项目构建流程和输出结果。