在使用 Code Composer Studio (CCS) 开发 DSP 或 ARM 工程时，经常会遇到这样一个问题：

• 在 A 电脑上能正常编译的工程，拷贝到 B 电脑上后就报错。

• 错误的原因通常是 工程使用了绝对路径，而不同电脑上的文件路径不一致，比如：

• 

这样，每次换电脑或者更换目录，就得重新修改路径，非常麻烦。
解决办法就是——统一使用相对路径。

1. 常见的路径宏

CCS 提供了以下常用宏，可以帮助你写相对路径：

${workspace_loc} ：当前 CCS 工作区（workspace）路径。

• 依赖工作区 (Workspace)：它的前提是工程必须在某个 CCS Workspace 下，才能通过${ProjName} 解析出工程路径。

• 适用场景：如果你有多个工程放在同一个 Workspace，并且它们之间需要共享一些公共的 include/lib，可以用这种写法。

${ProjName} ：当前工程名称路径，更独立，不依赖 Workspace 的路径。

${PROJECT_ROOT} ：当前工程的根目录。

• 独立于 Workspace：它直接指向工程自身所在目录，不依赖 Workspace 的路径。

• 可移植性最好：无论工程在哪个 Workspace 下，甚至把工程单独 copy 给别人（别人 import 工程），这个路径依然有效。

• 推荐用法：工程自己的 include/、lib/ 目录建议用这种写法。

${CG_TOOL_ROOT} ：当前工程使用的编译器 (Code Generation Tools) 的安装目录。

 示例：

本地工程路径

本地编译器安装路径

${workspace_loc:/${ProjName}/include}  
//表示D:\CCSWorkspace\ProjectTest\include

${PROJECT_ROOT}/include                
//表示D:/CCSWorkspace/ProjectTest/include

${PROJECT_ROOT}/lib                    
//表示D:/CCSWorkspace/ProjectTest/lib

${CG_TOOL_ROOT}/include                
//表示C:/Software/CCS1230/ccs/tools/compiler\ti-cgt-c2000_22.6.0.LTS/includ

${CG_TOOL_ROOT}/lib                    
//表示C:/Software/CCS1230/ccs/tools/compiler\ti-cgt-c2000_22.6.0.LTS/lib

2. 修改 include 路径

2.1 右键工程 → Properties

2.2 进入 Build → Compiler → Include Options

2.3 在 Add dir to #include search path 中添加：

${PROJECT_ROOT}/include

${workspace_loc:/${ProjName}/include}

${CG_TOOL_ROOT}/include

这样，头文件搜索顺序就是：

• 先找工程目录下的 include

• 再找工作区路径

• 最后找编译器默认的 include

3. 修改 lib 路径

3.1 右键工程 → Properties

3.2 进入Build → Linker →File Search Path 

3.3 在 Add <dir> to library search path (--search_path, -i) 里添加：

${PROJECT_ROOT}/lib

${workspace_loc:/${ProjName}/lib}

${CG_TOOL_ROOT}/lib 

（注意：如果工程目录下没有lib文件，只需要添加${CG_TOOL_ROOT}/lib 即可）

4. 推荐的工程目录结构

为了更方便使用相对路径，可以在工程下保持统一的结构：

ProjectName/

│── include/   # 头文件

│── lib/      # 库文件

│── source/    # 源代码

│── linker.cmd  # 链接命令文件

│── .project   # CCS 工程文件

这样只需写：

${PROJECT_ROOT}/include

${PROJECT_ROOT}/lib

即可完成配置。

5. 总结

• 绝对路径 → 只能在本机使用，不利于分享

• 相对路径（推荐） → 通过 ${PROJECT_ROOT}、${workspace_loc} 等宏来配置

• lib / include 建议放在工程目录内，统一管理，减少依赖

这样设置后，你的 CCS 工程就可以在任何电脑上直接编译，无需修改路径配置，大大提升了可移植性和可维护性。