VS Code + Markdown + 腾讯云 COS 笔记管理

整体目标

本地用 VS Code 编辑 Markdown 笔记，粘贴图片时自动生成相对路径，手动将笔记 + 压缩后的图片备份到腾讯云 COS。

前置准备

环境 / 账号准备

安装最新版 VS Code（官网下载）；

开通腾讯云 COS 服务：

登录腾讯云控制台，搜索「对象存储 COS」并开通；
创建存储桶（建议「私有读」，地域选就近的如 ap-guangzhou，存储桶名称记下来）；
进入「访问管理 → 密钥管理」，创建 API 密钥（SecretId/SecretKey，记下来，后续备份用）。

本地笔记目录初始化

在电脑本地新建统一的笔记根目录（如D:/Notes），后续所有笔记都放在这个目录下，目录结构示例：

plaintext
D:/Notes/
├── 学习笔记/        # 分类文件夹
│   └── Python基础.md # 笔记文件
└── 工作记录/
    └── 项目复盘.md

步骤 1：VS Code 配置（粘贴图片自动压缩 + 相对路径）

打开 VS Code 设置文件：快捷键 Ctrl+Shift+P → 输入「Preferences: Open User Settings (JSON)」→ 回车；
将以下配置粘贴到 settings.json 中：

{
    // markdown同级存放图片目录
    "markdown.copyFiles.destination": {
        "**/*": "images/${documentBaseName}/"
    },
    // 工作区固定目录(按需选取)
    "markdown.copyFiles.destination": {
        "**/*": "${documentWorkspaceFolder}/assets/"
    }
}

保存 settings.json，配置立即生效。

步骤 2：本地编辑笔记（粘贴图片自动压缩）

2.1 打开笔记目录

VS Code → 左上角「文件」→「打开文件夹」→ 选择本地笔记根目录（如D:/Notes）。

2.2 新建 / 编辑 Markdown 笔记

右键笔记目录 →「新建文件」→ 命名为XX笔记.md（如Python基础.md）；
正常编辑文字内容，需要插入图片时：
截图 / 复制图片（如微信截图、本地图片）；
在 Markdown 中光标定位到要插入图片的位置；
按快捷键Ctrl+V），图片会自动：
保存到./images/笔记名/目录（相对路径，如./images/Python基础/image.png）；

2.3 本地预览验证

编辑完成后，按Ctrl+Shift+V打开 Markdown 预览；
确认图片正常显示（相对路径生效），本地图片目录和笔记文件路径对应。

步骤 3：手动备份笔记 + 图片到腾讯云 COS

3.1 选择备份工具（二选一）

方式 1：腾讯云 COS 控制台手动上传（适合新手 / 少量笔记）

登录腾讯云 COS 控制台 → 进入你的存储桶；

点击「上传文件 / 文件夹」→ 选择本地笔记根目录下的文件 / 文件夹：

笔记文件（.md）直接上传；

图片文件夹（images）整体上传（已压缩，无需额外处理）；

保持云端目录结构和本地一致（如云端也创建学习笔记/images/）。

方式 2：COSCLI 命令行上传（适合批量 / 频繁备份，推荐）

安装 COSCLI：

下载地址：腾讯云 COSCLI 官网，按系统（Windows/Mac/Linux）下载并配置环境变量；

配置 COSCLI，并注册到环境变量：

打开终端（CMD/PowerShell）→ 执行

coscli config

输入模式选择
在Input Your Mode:后输入1（默认推荐的交互模式），该模式会引导你逐步填写 COS 的配置信息，更适合新手。

后续配置步骤（输入1后的流程）
输入1后，会依次提示你填写以下信息：

// 1. 启动coscli配置
coscli config

// 2. 选择配置模式：输入1（交互模式，新手推荐）
Input Your Mode:
1

// 3. 输入API密钥（从腾讯云密钥管理获取）
Input Your Secret ID:
AKIDvjLp8H**************3A3jInBPQ  // 替换为你的SecretId
Input Your Secret Key:
sY2JSdljUI**************7LPGxTUL4      // 替换为你的SecretKey

// 4. Session Token：永久密钥场景，直接按回车跳过
Input Your Session Token:
（直接回车，无需输入）

// 5. 禁用加密：使用默认值false（启用加密传输，更安全），回车跳过
Disable encryption (DisableEncryption)? (true/false, default: false):
（直接回车）

// 6. 禁用自动获取存储桶类型：默认值false（自动识别，避免配置错误），回车跳过
Disable automatic bucket type fetching (DisableAutoFetchBucketType)? (true/false, default: false):
（直接回车）

// 7. 禁用自动切换备份域名：默认值false（启用自动切换，提升稳定性），回车跳过
Disable automatic backup domain switching (CloseAutoSwitchHost)? (true/false, default: false):
（直接回车）

// 8. 输入存储桶名称（格式：存储桶名-APPID，从COS控制台获取）
Input Your Bucket's Name:
Format: <bucketname>-<appid>，Example: example-1234567890
notes-1304806518  // 替换为你的存储桶全称

// 9. 输入存储桶Endpoint（格式：cos.地域.myqcloud.com）
Input Bucket's Endpoint:
Format: cos.<region>.myqcloud.com，Example: cos.ap-beijing.myqcloud.com
cos.ap-shanghai.myqcloud.com  // 替换为你的地域对应的Endpoint（上海地域示例）

// 10. 存储桶别名：无需设置，直接回车使用原始名称
Input Bucket's Alias: (Input nothing will use the original name)
（直接回车）

// 11. 输入配置集名称（自定义或回车用默认名）
Input Your Name:
note-cos-config  // 自定义名称，便于识别，也可直接回车用default

执行备份命令：

终端进入本地笔记根目录（如cd D:/Notes）；

执行同步命令：

coscli sync ./ cos://你的存储桶名称/Notes/ --include .md --include .png --include .jpg --include .webp；

命令说明：将本地当前目录的.md 和图片文件同步到云端Notes/目录，保持路径一致。

@echo off
chcp 65001 >nul 2>&1
title 笔记备份到腾讯云COS

:: ====================== 请手动修改以下配置项 ======================
set "DIR=E:\"  :: 盘符
set "NOTE_ROOT_DIR=./Notes"  :: 你的本地笔记根目录（改为自己的路径）
set "COS_REMOTE_DIR=notes-1304806518/notes"  :: 腾讯云COS存储桶名称+路径
:: =================================================================

:: 【修复1】正确检查笔记目录是否存在
cd /d "%DIR%" || (
    echo 错误：盘符 "%DIR%" 不存在！
    pause
    exit /b 1
)
if not exist "%NOTE_ROOT_DIR%" (
    echo 错误：本地笔记目录 "%NOTE_ROOT_DIR%" 不存在！
    pause
    exit /b 1
)

:: 执行COS同步命令（仅同步md和图片文件）
echo 开始同步笔记到腾讯云COS...
echo 本地目录：%NOTE_ROOT_DIR%
echo 云端目录：cos://%COS_REMOTE_DIR%
echo.

:: 【修复2】路径末尾加/，规范同步目录内容（而非目录本身）
coscli sync "%NOTE_ROOT_DIR%/" cos://%COS_REMOTE_DIR% -r --delete

:: 【修复3】正确判断同步结果（errorlevel 0 表示成功，非0表示失败）
if %errorlevel% equ 0 (
    echo.
    echo ======================
    echo ✅ 备份完成！
    echo ======================
) else (
    echo.
    echo ======================
    echo ❌ 备份失败！请检查：
    echo 1. COSCLI是否已安装并配置
    echo 2. 存储桶名称是否正确
    echo 3. 本地目录是否存在
    echo ======================
)

pause

3.2 备份验证

注意事项

密钥安全：COS 的 SecretId/SecretKey 不要泄露，COSCLI 配置后会加密存储，无需担心；
增量备份：COSCLI 的sync命令默认只上传新增 / 修改的文件，批量备份效率高。

总结

核心流程：本地初始化目录 → VS Code 配置 → 编辑笔记 → 手动同步到 COS。全程无额外脚本，仅通过配置和 COS 官方工具实现，兼顾易用性和资源节省，符合笔记管理的核心需求。

posted @ 2026-01-03 17:41 敲可耐的咕魂君阅读(33) 评论(0) 收藏举报

刷新页面返回顶部

敲可耐的咕魂君