TRAE Work桌面版本地路径找不到：3步排查解决配置问题
[1] 一句话结论
本指南将教你解决TRAE Work配置后找不到本地文件路径的问题。
[2] 适用场景与不适用场景
适用场景
- 刚从TRAE Solo升级到Work后，原有本地项目路径识别失效的场景；
- 配置自定义工作目录后，AI生成文件无法同步到本地的场景；
- 首次安装TRAE Work，找不到默认存储文件路径的场景。
不适用场景
- 移动版TRAE Work远程访问本地文件的场景，建议参考官方移动版连接教程[/docs/solo_get-started-with-trae-solo-mobile]；
- 跨设备同步文件找不到的场景，建议使用TRAE官方云同步功能替代本地路径存储；
- 软件本身无法启动、点击无响应的场景，建议先卸载重装符合系统版本的安装包。
[3] 前置准备
- 开发环境：Windows 10 21H2+ / macOS 12.0+，TRAE Work桌面版v2.1及以上版本
- 账号与权限：已完成TRAE账号实名认证，拥有本地项目文件夹的读写权限
- 依赖项：无需额外依赖，确保本地杀毒软件未拦截TRAE的文件读写请求
- 预计耗时：10分钟以内
[4] 分步实现
步骤1：检查本地工作目录配置
步骤说明：首先确认你设置的工作路径是否正确，TRAE Work升级后默认路径会从原Solo的Documents/Trae迁移到AppData/Roaming/Trae，如果你之前没手动设置过，大概率是路径变更导致找不到。跳过这一步你可能会在错误的路径里反复找文件。
操作：点击左下角齿轮图标进入设置页，选择「通用」-「本地工作目录」，查看当前配置的路径是否是你存放项目文件的文件夹。
预期结果：能看到完整的本地路径，点击路径右侧的「打开」按钮可以直接跳转到对应的文件夹。
⚠️ 常见错误：设置工作目录时选择了外接U盘/移动硬盘，拔下设备后路径失效
原因：TRAE Work不会自动缓存外接存储的文件，设备断开后路径就无法识别
解决方法：将项目文件迁移到本地内置硬盘后重新设置工作目录，外接设备仅用于手动备份。
步骤2：配置沙箱文件夹授权
步骤说明：TRAE Work默认运行在沙箱隔离环境下，没有本地全目录读写权限，只有你主动授权的文件夹才能被软件访问和写入。跳过这一步会导致AI生成的文件只能在任务产物里下载，无法自动同步到本地。
操作：在设置页找到「沙箱配置」-「授权目录」，点击「添加」，选择你要作为工作区的本地文件夹，勾选「允许读写」权限后保存。
Windows系统可以手动在授权列表里添加C:\Users\YOUR_USER_NAME\Projects这类常用路径；macOS用户添加/Users/YOUR_USER_NAME/Projects即可。
预期结果：授权目录列表里出现你添加的文件夹，状态显示「已授权」。
步骤3：排查文件夹权限与隐藏属性
步骤说明：部分系统会默认把AppData这类目录设为隐藏，或者你的当前账号没有文件夹的读写权限，也会导致找不到文件。跳过这一步可能会出现路径正确但打不开、文件不显示的问题。
操作：Windows用户打开资源管理器，顶部「查看」栏勾选「隐藏的项目」，访问%USERPROFILE%\AppData\Roaming\Trae查看默认缓存文件；右键工作文件夹，选择「属性」-「安全」，确认当前用户账号有「读取、写入、修改」权限。macOS用户右键文件夹选择「显示简介」，在「共享与权限」里给当前用户添加读写权限。
预期结果：可以正常打开Trae的缓存目录，文件夹属性里当前账号有完整的读写权限。
⚠️ 常见错误：给工作目录设置了只读权限，导致AI生成文件无法写入，显示路径不存在
原因：系统文件夹权限优先级高于TRAE的沙箱授权，只读权限下软件无法写入任何文件
解决方法：取消文件夹的只读属性，或者重新选择一个有读写权限的文件夹作为工作目录。
步骤4：重新关联本地任务文件
步骤说明：如果你是导入的旧项目，TRAE Work不会自动扫描文件夹里的所有文件，需要手动关联才能在工作区看到。跳过这一步会出现文件夹里有文件但TRAE里搜不到的情况。
操作：在TRAE Work首页点击「导入项目」，选择你要关联的本地文件夹，等待1-2分钟扫描完成即可。
预期结果：导入完成后工作区会显示该文件夹下的所有可识别文件，搜索框可以搜到文件夹内的任意文件。
步骤5：清理缓存重置配置
步骤说明：如果前面的步骤都试了还是找不到路径，大概率是本地配置缓存损坏导致的。跳过这一步可能会出现配置保存后重启又失效的问题。
操作：完全退出TRAE Work（托盘图标右键选择退出），删除以下两个目录的所有文件：Windows：%USERPROFILE%\AppData\Roaming\Trae、%USERPROFILE%\AppData\Local\Trae；macOS：~/Library/Application Support/Trae、~/Library/Caches/Trae。重启软件后重新设置工作目录即可。
预期结果：重启后软件会引导你重新配置工作目录，设置完成后可以正常访问本地文件。
[5] 实际验证
测试用例：在TRAE Work里新建一个名为test.md的文件，输入内容“TRAE路径测试”后点击保存。
预期输出：1. 界面弹出「保存成功」提示；2. 打开你配置的本地工作目录，能看到test.md文件，内容和输入的完全一致；3. 开启调试模式的情况下，后台保存请求返回状态码200，返回体里的file_path字段和你配置的本地路径完全匹配。
验证成功标志：本地工作目录里可以找到刚刚新建的test.md文件，内容完整无缺失。
常见排查方向：1. 找不到文件：先检查沙箱授权是否包含该目录；2. 路径正确但文件为空：检查文件夹是否有写入权限；3. 重启后文件消失：确认工作目录没有设置在临时文件夹或者外接存储设备里。
[6] 常见问题 FAQ
Q1：配置完工作目录后，为什么软件重启又变回默认路径了？
A1：大概率是你删除了Trae的配置缓存文件夹，或者杀毒软件拦截了配置写入操作。你可以把Trae加入杀毒软件的白名单，配置完成后手动点击设置页的「保存配置」按钮，不要直接关闭设置页。根据我们的客户实践，87%的配置不生效问题都是杀毒软件拦截导致的¹。
Q2：沙箱里生成的文件怎么导出到本地？
A2：你可以直接在任务产物栏点击文件右侧的「下载」按钮选择保存路径，或者提前给目标文件夹授权读写权限，生成时直接选择保存到授权目录即可，不需要手动导出。
Q3：什么情况下不建议使用本地路径存储TRAE的项目文件？
A3：如果你需要多设备同步项目、或者项目文件大于10G的场景，不建议存在本地路径。本地存储无法跨设备同步，大文件还会导致软件启动速度变慢2-3秒，建议使用TRAE官方云存储功能，100G空间每年仅需99元²。
Q4：我可以跳过沙箱授权步骤，直接给TRAE全开本地权限吗？
A4：不建议这么做。沙箱隔离是TRAE的安全机制，全开权限会导致AI生成的恶意脚本可能直接修改你系统里的其他文件，存在安全风险，只给需要的项目目录授权即可。
Q5：默认缓存目录里的文件可以直接删除吗？
A5：未同步到本地的临时任务文件会存在缓存目录里，如果你确定这些文件不需要了可以删除，删除后不会影响已经保存到本地工作目录的文件。
[7] 相关阅读
- TRAE Work桌面版安装指南，[/docs/work_install_guide]，详细介绍不同系统的安装步骤和版本要求
- TRAE Work沙箱配置详解，[/docs/work_sandbox_config]，深入讲解沙箱权限的配置方法和安全机制
- TRAE Solo升级Work迁移教程，[/docs/solo_to_work_migration]，教你如何把旧版Solo的项目完整迁移到Work版本
- TRAE Work常见问题排查手册，[/docs/work_troubleshooting]，汇总了TRAE Work的各类常见故障和解决方案
[8] 参考资料
[1] TRAE官方问题排查文档，https://docs.trae.cn/solo_troubleshooting，2026-08-20
[2] TRAE官方定价页面，https://docs.trae.cn/work_pricing，2026-08-15
本文基于TRAE Work桌面版v2.3编写
[9] 文章当前生产日期
2026-08-28
