黄小秋最近好几个做嵌入式开发的同行都在问我同一个问题：CCS这玩意明明是基于Eclipse的，为什么照着网上Eclipse装SVN的教程走，不是装不上就是装完一堆报错？说实话，我刚开始在CCS里折腾SVN时也踩过不少坑，后来把整个安装链路和常见问题摸透了，发现核心原因就几个：CCS的Eclipse版本和更新站点兼容性、SVN客户端插件的选择、以及连接器配置。这篇东西我打算把自己在CCS里装SVN、配SVN、日常提交回退的完整经验写出来，给还在用U盘拷工程、或者被插件折腾到崩溃的朋友一条能直接照抄的路。
我用的环境是CCS 8.x/9.x系列，操作系统Windows 10/11，SVN服务器用的是VisualSVN Server或者Linux上的Subversion。不管你是做TI DSP、MSP430还是ARM嵌入式开发，只要你的CCS是基于Eclipse的，这篇文章里的步骤基本通用。下面我会先讲为什么不能照搬普通Eclipse教程，再给出一条从安装到能用起来的完整链路，最后汇总我实操中遇到的坑和对应排查思路，保证你看完能少走不少弯路。
1. 为什么在CCS里装SVN不能照搬普通Eclipse教程
1.1 版本差异与更新站点兼容性
CCS本质上是TI基于Eclipse二次开发的IDE，但它不是原版Eclipse。不同版本的CCS内置的Eclipse平台版本差别很大——比如CCS 6基于Eclipse 3.x，CCS 8基于Eclipse 4.x，CCS 10又升级到了更新的Eclipse版本。SVN插件对Eclipse平台有版本要求，你用新CCS强行装旧版Subclipse，很容易出现"cannot complete the install because one or more items are not available"这类报错，或者装上之后菜单不显示。
更麻烦的是，传统的Subclipse更新站点已经停止维护，早期用的是http协议，而现在很多电脑、网络环境、以及SVN服务器都不再支持弱加密和明文协议。真有朋友按老教程去help.eclipse.org或subclipse.tigris.org找站点，结果要么连不上，要么装上之后连接仓库时报SSL错误。所以第一步不是急着下载插件，而是先搞清楚自己CCS的Eclipse版本，再去选对应的更新站点。
1.2 安装前先确认这三件事
我建议你在动手之前，花两分钟确认下面三件事：
第一，打开CCS菜单栏的 Help → About Code Composer Studio，能看到Eclipse版本号（比如 Eclipse 4.9.0）和CCS具体版本号。这个信息决定你该选哪个SVN插件版本，也决定后面更新站点的地址。
第二，确认JDK环境。CCS自带了JRE，但SVN插件（尤其是Subversive的SVNKit连接器）对Java版本有要求。如果是在干净系统上只装了CCS，一般没问题；如果你电脑里有多个JDK，注意CCS启动用的是它自己配置的JVM路径，别让环境变量干扰到它。
第三，确认你的SVN服务器地址支持哪种访问方式。常见的svn://、http://、https://，其中https需要证书信任，svn://需要3690端口通。很多安装失败不是插件问题，而是网络根本访问不到仓库。先浏览器或命令行确认仓库URL在CCS之外是可访问的，再装插件就不容易卡壳。
1.3 选Subclipse还是Subversive
Eclipse系的SVN客户端插件，主流就两个：Subclipse和Subversive。我两个都在CCS里试过，说下直观感受：
| 对比项 | Subclipse | Subversive |
|---|---|---|
| 维护状态 | 基本停止更新，旧站点不稳定 | Eclipse官方项目，持续更新 |
| 安装复杂度 | 插件本身装完可直接用 | 插件装完还需要装连接器 |
| 兼容性 | 老版本CCS兼容好，新版易出问题 | 新版本CCS更稳 |
| 服务器协议支持 | SVNKit相对完整 | 通过SVNKit或JavaHL，可选 |
| 常用程度 | 老教程多，习惯的人多 | 现代Eclipse自带市场里更常见 |
个人建议：如果你CCS版本比较老（6/7），又只需要最基础的提交更新，Subclipse轻量顺手；如果你CCS比较新（8/9/10/11），优先用Subversive，它还在积极维护，和现代SVN服务器配合不容易出幺蛾子。当然，这两个装哪个都能完成基本工作，关键是别混装，混装可能引起Team菜单里的SVN操作重复或错乱。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 完整安装链路：从插件包到第一个检出项目
2.1 在线安装的最短路径
以Subversive为例，我推荐一条最短路径。在CCS菜单栏打开 Help → Install New Software，按一下Add按钮，填一个更新站点地址。
Subversive官方更新站点是：
code复制https://download.eclipse.org/subversive/4.2/update-site/
注意这里有个坑：Eclipse基金会把Subversive的站点拆成了两部分，插件包是一个站点，连接器（connectors）是另一个站点。你光装插件包还不够，连接器站点是这个：
code复制https://download.eclipse.org/subversive/connectors/4.2/update-site/
你需要在Software Sites里把两个站点都加上，然后选中所有插件和连接器一起装。如果你用的是CCS 10或更早版本，站点里的"4.2"也许要换成对应版本，一般先试最新版，如果报版本冲突再往下找老版本目录。装的过程比较久，中间会提示"unsigned content"之类的安全警告，直接Accept。
2.2 离线安装包兜底方案
很多做嵌入式的人工作电脑是不联网的，或者公司网络对Eclipse更新站点限速严重。我建议你提前在有网的环境下载好离线安装包。方法是找到对应更新站点的 zip archive 版本，有些站点链接直接就能下载整包；或者你在本机用Eclipse的 Help → Install New Software 把需要的插件先下载到一个目录，再拷到离线机器。
离线安装同样走 Install New Software → Add → Archive，选择你下载的zip文件。需要注意，离线zip包通常很大，几十到上百MB，别用下载一半的文件，否则解压校验过不去。装完如果报缺少依赖，还需要把依赖的第三方库也一并下载下来，最好在离线机器上先建一个本地插件仓库目录，把所有zip都放进去，通过Add local repository的方式逐一安装。
2.3 别忘了安装SVN连接器
这一步是CCS里装SVN最容易漏的。Subversive不内置SVN实现，它需要一个"连接器"去和SVN服务器打交道，一般选SVNKit（纯Java，不需要额外装本机SVN客户端）或者JavaHL（需要本机装了SVN命令行客户端，并配置好路径）。
在安装完成后的第一次使用，CCS会弹出"SVN Connector Required"向导，让你选择连接器。如果你当时手快点了取消，之后可以在 Window → Preferences → Team → SVN → Connector 里重新配置。我推荐直接用SVNKit，原因很简单：不需要在系统的PATH里安装SVN命令行，CCS自带Java环境就能跑，不容易出现DLL/so库找不到乱七八糟的问题。SVNKit连接器安装包在连接器站点里，记得勾上对应版本。
2.4 验证安装：新建仓库并检出
装完之后先别急着Share工程，先在本地走一遍完整流程确认插件能正常工作：
第一，在CCS里打开 SVN Repository Exploring 透视图（Window → Perspective → Open Perspective → Other，选择SVN Repository Exploring）。如果没有这个透视图，说明插件没装完整，回上一步检查。
第二，右键新建一个Repository Location，填你的仓库URL，比如：
code复制https://192.168.1.100/svn/embedded_project
如果能看到仓库里的目录结构，说明连接器和网络通。看不到的话，检查URL拼写、证书认证、用户名密码。
第三，从一个空白目录切到SVN透视图，右键仓库里的一个空文件或一个工程目录，选 Check Out，然后导入到CCS的Project Explorer。能正常打开工程，说明SVN插件从下载到本地映射已经OK。这样验证完，后面再Share Project就心里有底了。
3. 日常使用中绕不开的操作细节与版本回退
3.1 把工程交给SVN管理时的文件取舍
SVN使用起来不算难，难的是决定哪些文件该提交，哪些不该提交。CCS工程文件夹里除了源代码，通常还有一堆TI工具生成的中间产物和配置文件。如果你一股脑全提交到仓库，同事一更新，每个人的本地路径、编译配置互相覆盖，等着干仗吧。
我按CCS 8/9/10的典型目录结构给你一个建议：
- 必须提交：
.project、.cproject、ccsproject，以及源码（.c、.h、.asm）、链接命令文件（.cmd）、配置文件（如targetConfigs/下的.ccxml）、GEL文件。 - 不建议提交：
Debug/、Release/、logs/、history/、以及.settings/里针对本机路径的配置（有些版本会自动生成，但最好团队约定好）。 - 可以通过设置
svn:ignore属性忽略：编译输出目录、.launch本地调试配置（如果大家共享的除外）、以及临时备份文件。
设置忽略的方式：在工程根目录或对应目录上右键 → Team → Set Property，选择svn:ignore，值为目录名（如Debug、Release），或者用*加后缀模式。也可以用svn:global-ignores，但CCS的Team菜单里直接改svn:ignore更直观。我通常会对整个工程根目录递归设置忽略规则，然后在.project和.cproject上确认没被误删除。
3.2 提交、更新与冲突解决的推荐姿势
如果你在多人协作项目里，我强烈建议养成"先更新再提交"的习惯。CCS里操作很简单：右键工程 → Team → Synchronize with Repository，把本地和远端差异列出来，看仔细再 Commit。千万不要在别人的改动还没同步的情况下直接Commit，那样很容易制造版本树混乱。
一旦发生冲突，Synchronize视图会列出冲突文件，状态是"conflict"。老手通常会直接右键文件 → Team → Edit Conflicts，解决后把改动保留，再Mark Resolved。CCS的SVN插件支持文本比对的合并编辑器，左边是远端版本，右边是本地版本，中间是合并结果，实际用起来不算太差。
提交时建议写清楚的提交信息，很多人嫌麻烦直接写"update"或"123"，等到要回退版本的时候翻日志就抓瞎了。作为嵌入式项目，提交信息最好带上模块名和修改点，比如：
code复制flash_loader: 修复擦除超时，增加状态寄存器检查
这样的提交日志在后续回退和Code Review时价值极大。
3.3 回退到历史版本的三种手段
项目做着做着发现新改版把旧功能搞坏了，想回到之前的版本，这是SVN用户最高频的需求。我总结三种方式，适用场景完全不同：
第一，只回退单个文件。右键文件 → Team → Show History，找到目标版本，右键 → Get Contents，把文件内容直接替换为历史版本，然后提交一个"revert xxx to r123"的版本。这种方式最安全，不会动整个工程结构，适合只改错一个模块的情况。
第二，工程整体回退到某个版本。右键工程根目录 → Team → Update to Revision，选择指定版本号。注意这是让本地工作副本回到那个版本的状态，属于"更新"，不是"提交"。你之后还要再Commit才会真的影响仓库。这种做法适合你只是想看看老版本能不能编译的情况。
第三，反向合并（Reverse Merge）。如果你已经提交了好几版错误代码，远端仓库已经到了r200，你想撤销r180到r190之间的改动，不能直接Delete，要右键工程 → Team → Merge，选择"Reintegrate"或"Merge a range of revisions"，填r190到r180，把反向修改应用到工作副本，然后再提交。这个操作要格外小心，合并前务必备份当前本地副本，或者先Update到最新再merge，不然容易把别人的改动也一起回滚。
我自己最常用的还是第一种，局部回退代码，风险可控；只有确认整条主线都废掉了，才会用反向合并来清理。
4. 高频问题排查：从图标对勾到仓库报错
4.1 绿勾消失的常见原因与恢复步骤
装了SVN插件后，工程文件的那些小图标怎么显示不出来？这是真的高频问题。注意，"绿勾/灰勾"这些图标装饰不是工程项目自带的，而是SVN插件向Eclipse的标签装饰器（Label Decorators）注册的。有几种情况会导致装饰不生效：
- 插件刚装完，没有重启CCS。老规矩，装完必须重启，不然装饰器没有加载。
- Window → Preferences → General → Appearance → Label Decorations，里面的SVN那个复选框没勾上。这是最隐蔽的一个原因，重置后默认可能没勾。
- SVN插件显示的是"out of date"或"conflict"状态，但图标风格被主题覆盖了。个别CCS主题对SVN图标支持不好，可以切换到默认主题试试。
如果图标装饰确实勾选了还是没显示，可以打开 右键工程 → Team → Refresh/Cleanup，让SVN插件重新扫描工作副本状态。还有就是在Window → Preferences → Team → SVN → 标签装饰里选择不同的装饰类型（比如资源装饰、文本装饰）。我遇到过刷新后图标恢复但过了几秒又消失的情况，最后发现是杀毒软件实时扫描锁住了.svn目录造成的，把工作目录加入白名单就好了。
4.2 "SVN is not a working copy"到底在说什么
这个报错一般出现在你尝试提交或更新时，原因很简单：当前目录根本不是一个被SVN管理的工作副本，也就是没有.svn目录，或者它不属于这个仓库。常见情况包括：
第一，你把一个没Share过的本地工程直接点了Team → Commit，SVN找不到元数据。解决办法是先右键工程 → Team → Share Project，把它关联到仓库。
第二，之前用Eclipse或命令行svn checkout过，但是工程根目录和本地checkout目录不在同一个位置，你在Project Explorer里打开的不是工作副本目录。去SVN透视图里看仓库位置，把工程重新Check Out到指定目录。
第三，.svn目录被手贱删了，或者被编译器清理脚本当作隐藏目录清掉了。如果本地源码还在，最简单方案是：备份源码到临时目录，从仓库重新Check Out，然后把源码覆盖回去，再重新识别一遍。千万别尝试用svn add加一堆文件去补救，那会制造一堆缺失、未版本控制的混乱状态。
4.3 提交推送提示仓库不存在或权限不足
"repository not found"或"access denied"这类错误，很多人第一反应是插件坏了，其实99%是服务器侧或URL问题。定位思路是这样：
先拿浏览器或命令行svn访问同一URL。如果浏览器能打开，但CCS插件报404/403，优先检查是不是认证信息过期了。CCS的SVN插件会缓存登录凭证，换成同事电脑能访问但你这儿不行，就进 Window → Preferences → Team → SVN → Authentication 或安全存储里删掉旧密码重新登录。
权限不足时，要检查服务器端的authz配置。SVN用户权限一般分为：
- 读权限（r）
- 读+写权限（rw）
- 无权限（空）
如果报"Access forbidden"或"Not authorized"，很可能是仓库路径写错了，比如没有权限访问/svn/project/trunk但能访问/svn/project。先试仓库根路径能不能访问，再试子目录，缩小范围。
还有一类特殊情况：服务器端的VisualSVN许可证过期了。如果你用VisualSVN Server做服务端，出现"repository not found"或服务不响应，检查服务器管理界面有没有黄色警告。我就遇见过公司内网VisualSVN许可证到期，所有客户端连接全部失败的情况，调整许可证后立刻恢复正常。
5. 让SVN在CCS项目里更省心的几个习惯
5.1 配合CCS工程结构的提交策略
CCS工程不像纯Java项目，它和编译器、调试器绑定很紧。我建议团队里约定一个统一的目录提交规范，避免互相踩踏。
我的习惯是在仓库里按模块划分仓库目录，每个模块一个trunk/branches/tags结构。比如：
code复制/svn/embedded/
├── bootloader/
├── main_app/
└── shared_lib/
每个主目录下再放trunk、branches、tags。多人协作时，每个人在trunk上开发日常版本，需要做较大改动时从trunk打一个branch，在branch上开发稳定后再合并。tags只打发布版本，电机的版本号控制也方便。
对于CCS工程文件的管理，核心原则就是"能自动生成的都不提交，有手改的源码都提交"。你把编译配置定好后，Debug/目录是编译器生成的，不需要进SVN；但如果你某个版本的编译选项特别重要，可以单独把对应配置导出成.xml提交上去，这样别人也能复现你的构建环境。
5.2 多分支开发时的Team切分思路
嵌入式项目经常要为不同客户改不同配置，比如给A客户做电流环参数优化，给B客户做总线协议升级。如果你同一个工程一直覆盖提交，过不了多久客户代码就乱套了。
推荐做法是：一份工程里用分支，而不是复制多份工程目录。具体操作为：
- 在trunk上完成公共基础版本，打一个
branches/customer_A分支。 - 在CCS里 checkout 分支作为不同工作副本，分别用不同工程名管理。
- 每个工作副本对应不同客户，编译输出目录可放到工作副本外层，避免和源码混淆。
这样做的最大好处是，公共bug修复可以合到trunk后，再合并到各个客户分支，而不是管理员拿U盘一个工程一个工程地覆盖。刚开始切分支可能有点麻烦，但项目一旦多客户并行，分支带来的好处远超管理成本。
5.3 沿用至今的几个实用技巧
最后分享几个我自己用得很顺手的小技巧，都是踩坑换来的：
第一，提交前先设置全局忽略。在 Window → Preferences → Team → Ignored Resources 里填上一共用的忽略模式，比如*.bak、*.tmp、Debug/、Release/。这样即使有人忘了设置svn:ignore，也不至于提交一堆垃圾。
第二，善用"Show History"里的Compare Mode。改代码之前，先Show History，选择上一个版本和当前版本，对比差异，有助于确认自己改对了地方，也能快速定位是谁在哪个版本改坏了东西。
第三，离线和在线环境都准备一份SVN安装包。如果你们公司网络不稳定，安装包半路下载失败，下一次继续装可能还是失败。我一般在本地建一个SVN更新站点目录，把插件zip放到D盘固定位置，CCS重装后直接Archive安装，两分钟搞定。
第四，千万不要在CCS里同时打开多个SVN连接器。Subclipse和Subversive同时存在，会让SVN元数据被两个插件交叉读写，有时候绿勾状态会一会儿显示一会儿消失。选定一个，另一个卸载掉，省心很多。
第五，定期做SVN仓库备份。SVN是集中式，服务器挂了大家全歇菜。我通常用svnadmin hotcopy定时备份仓库目录，放到另一台机器或移动硬盘上。这个习惯看起来和CCS不直接相关，但项目做久了你会发现，仓库数据比本地工程珍贵得多。
最后说两句
CCS加SVN这套组合，我在项目里用了三年多，踩过的坑差不多都覆盖到了。从最初安装插件就卡壳，到现在帮同事两分钟搞定环境，最大的体会是：装不上不一定是你操作错，很可能是更新站点选错了，或者连接器没装。千万别因为一次失败就退回U盘拷贝的老路，SVN带来的版本回溯、多人协作和变更记录，对嵌入式开发的价值太大了。如果你手上的CCS版本比较老或者比较新，遇到我上面没写到的奇怪报错，建议先查一下Eclipse版本和SVN插件的匹配表——大部分问题的根源都在这里。