CodeSnap 插件需手动触发截图，不自动截屏也不注入右键菜单；截图范围仅限选中文本行及默认2行边距；配置须修改settings.json，图形界面设置无效；图片默认存下载目录，文件名含时间戳与随机字符串。
CodeSnap 插件根本不会自动截图，必须手动触发
很多人装完 CodeSnap 就等着右键菜单弹出“截图”选项，结果发现没有——因为插件默认不启用快捷键，也不注入右键菜单。它只在你明确执行命令时才工作。
实操建议：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入CodeSnap: Snap并回车 - 或者给它配个快捷键：打开设置 → 键盘快捷方式 → 搜索
codesnap.snap→ 右键绑定（比如设成Alt+S） - 别依赖右键菜单；新版 VSCode 默认禁用插件的上下文菜单项，除非插件显式声明
when条件且你正选中代码
截图区域由光标位置和选中文本共同决定，不是“当前文件视图”
CodeSnap 不截整个编辑器窗口，也不截当前折叠/滚动看到的部分。它只截你**实际选中的文本行范围**（哪怕只选了一个字符，也会扩展到整行），再加一点上下文边距（默认 2 行）。
常见错误现象：
- 想截函数但只选了函数名 → 结果只有一行，没函数体
- 没做任何选择就执行
CodeSnap: Snap→ 截的是光标所在那一行（不是当前可视区域） - 选中跨多屏的长代码 → 它仍只按文本行数截，不会自动分页或压缩
使用场景提示：适合截逻辑块、配置片段、报错上下文。不适合截带终端输出、调试面板或侧边栏的“全屏效果”。
导出图片样式靠 JSON 配置，settings.json 里改才生效
界面上点“设置”进图形化面板改 CodeSnap 选项？大概率无效。它的主题、字体、边框等核心参数只读取用户 settings.json 中的 "codesnap.*" 字段。
关键参数差异：
-
"codesnap.theme": "dark-plus"—— 必须填 VSCode 内置主题名，填"GitHub Dark"这类第三方主题名会回退到默认 -
"codesnap.fontFamily": "'Fira Code', monospace"—— 字体名含空格或短横线必须加单引号 -
"codesnap.showLineNumbers": false—— 设为false才真隐藏行号；设成"false"（字符串）会被忽略
性能影响：开启 "codesnap.showWindowControls": true 会在图上画假的 macOS 窗口按钮，但会让生成变慢 200–300ms，纯分享用可关掉。
截图保存路径和文件名不能实时预览，容易覆盖或找不到
执行 CodeSnap: Snap 后，图片默认存在 ~/Downloads/（macOS/Linux）或 %USERPROFILE%\Downloads\（Windows），文件名是时间戳 + 随机字符串，比如 snap-1715289342612.png。你不会看到保存对话框，也不会在 VSCode 里提示路径。
容易踩的坑：
- 连续截 3 张图，全堆在下载目录，靠名字根本分不清哪张是哪个函数
- 用 OneDrive 或 iCloud 同步下载目录？可能因文件锁导致截图失败，错误信息是
EPERM: operation not permitted - 想改默认路径？只能手动改
"codesnap.outputPath"，值必须是绝对路径，相对路径（如"./snaps"）会被忽略
复杂点在于：它不校验目标目录是否存在，也不自动创建子目录。设成 "codesnap.outputPath": "/path/to/project/snaps" 之前，得先确保 snaps 文件夹已经建好，否则截图直接静默失败。
