必须使用lukasz-wronski开发的ftp-sync插件（蓝底白箭头图标、v0.4.11），配passive:true、remotepath为宝塔ftp根目录的相对路径，禁用uploadonsave防空文件上传，并正确设置ignore排除.vscode/.git/node_modules。
用CLine插件调用DeepSeek生成代码，不是补全而是执行
VSCode里装个AI插件不等于就能自动生成可用代码——关键在它能不能理解上下文、读取文件、修改内容并执行命令。CLine正是这样一种“可行动”的AI代理，它不只输出建议，还能直接写入文件、运行npm run dev、甚至根据错误日志反向修复代码。
常见错误现象：CLine: Command not found 或 Permission denied: exec，多数是因为没开工具调用权限；更隐蔽的是模型返回了伪代码（比如用console.log代替真实API调用），但插件默认照单全收。
- 必须在配置中显式启用工具调用：
"tools": ["executeCommand", "readFile", "writeFile"] - DeepSeek的
endpoint要指向v1/chat/completions而非v1/models，否则会卡在鉴权环节 - 首次使用前，在命令面板执行
Cline: Toggle Tools手动开启工具开关，否则所有执行类操作都被静默忽略
FTP-Sync同步失败时，先查uploadOnSave和ignore冲突
自动同步失效，90%不是网络或密码问题，而是本地配置和远程路径逻辑打架。比如你设了"remotePath": "/www/wwwroot/site"，但ignore里写了"**/node_modules/**"，而宝塔FTP账户权限只开放到/www/wwwroot一级，就会导致整个同步流程静默退出，连错误提示都不抛。
典型场景：前端项目改完index.html，保存后页面没更新——实际是ftp-sync.json里"uploadOnSave": true开着，但"ignore"列表误加了"*.html"（注意通配符匹配规则是glob，不是正则）。
-
ignore项必须用双星号**表示任意层级，单星号*只匹配当前目录 - 宝塔FTP用户主目录若限制为
/www/wwwroot/site，remotePath就不能填/，否则上传会报550 Permission denied - 测试同步是否真生效：改一个被
ignore排除的文件（如README.md），看它会不会上传——这是最快速的验证方式
Settings Sync同步扩展时，sync.ignoredExtensions得填ID不是显示名
想让某插件不跨设备同步？别在设置里勾选“忽略”，那只是UI层开关。真正起作用的是settings.json里的sync.ignoredExtensions数组，而且必须填插件ID，比如"ms-python.python"，而不是“Python”这个显示名。
容易踩的坑：同步后新设备上突然多出一堆不想要的插件（比如cpptools），或者关键插件（如ftp-sync）没装上——往往是因为旧设备卸载过插件但没清理sync.ignoredExtensions，导致同步列表错乱。
- 插件ID可在VSCode扩展页URL里找到：
https://marketplace.visualstudio.com/items?itemName=ms-python.python→ ID是ms-python.python - 同步前检查
sync.ignoredExtensions是否包含已卸载插件的ID，残留条目会干扰新设备安装逻辑 - 团队共用同一同步账户时，
sync.ignoredExtensions应统一维护在共享配置模板里，避免成员各自忽略不同插件造成环境分裂
多个插件共存时，ftp-sync.json和sftp.json不能混用协议
有人同时装FTP-Sync和SFTP插件，以为能自动切换——实际上它们的配置文件完全独立，且协议不兼容。比如你在ftp-sync.json里写了"protocol": "sftp"，插件会直接报错Unknown protocol: sftp，因为FTP-Sync只认ftp和ftps。
性能影响明显：FTP-Sync走纯FTP协议，上传大文件时没断点续传；SFTP插件用SSH通道，支持uploadOnSave但首次连接慢2–3秒。选哪个取决于你的服务器环境——宝塔默认FTP服务开在21端口，SFTP需额外开22端口并配SSH密钥。
- FTP-Sync的
host填IP即可，SFTP插件的host必须是域名或IP，且username要跟宝塔FTP账户名一致（不是系统用户名） - 别把两个插件的配置文件都放在
.vscode/下还起名ftp.json——VSCode不会自动识别，得靠插件自己读取固定路径 - 调试同步问题时，先禁用另一个插件再测试，避免日志混杂导致定位困难
复杂点在于，AI生成、代码同步、设置同步三类插件各自维护一套状态，但它们共享同一个.vscode/目录和用户配置空间。一个插件写的settings.json可能覆盖另一个插件的配置项，而这种覆盖往往没有提示。
