「トラックボール 買う」で調べると、

親指型と指置き型という2種類があって何が違うのか分からない。

私も最初、全く同じ状態でした。

「どっちでもいっか」とテキトーに選んで後悔したくない。

でも違いを説明している記事を読んでも、難しすぎてよくわからない。

今回は、両方使い込んだ私が

「あなたにはどっちが合うか」

を徹底的に解説します。

そもそも2種類のタイプとは？

親指型（Thumb Type）

「マウスに似た形で、親指でボールを操作する」

本体を手のひらで握る
  → 親指でボールを転がす
  → カーソルが動く

代表機種：

• Logicool M575S
• Logicool MX ERGO S
• ELECOM EX-G

見た目は普通のマウスに近い。

マウスから乗り換えやすいのが特徴です。

指置き型（Index/Middle Finger Type）

「大きなボールの上に人差し指と中指を置いて操作する」

手のひらを本体の上に乗せる
  → 人差し指・中指でボールを転がす
  → カーソルが動く

代表機種：

• Kensington Expert Mouse
• ELECOM HUGE

ボールが大きく（52〜57mm）、

より精密な操作ができるのが特徴です。

5つの比較軸で徹底検証

📊 比較まとめ表

①精度・精密操作のしやすさ

指置き型が圧倒的に有利です。

理由は2つ。

理由1：操作する指の数

親指型：親指1本で操作
  → 親指の可動域は限られている
  → 細かい操作に限界がある

指置き型：人差し指+中指の2本で操作
  → 指先の感覚が繊細
  → ピクセル単位の精密操作が可能

理由2：ボールのサイズ

親指型：34mm（小さめ）
  → 1回の動きでカーソルが大きく動く
  → 微調整が難しい

指置き型：52〜57mm（大きめ）
  → 大きいボールは動かしやすく、精密に動かせる
  → 少ない動きで広い範囲をカバー

画像編集・動画編集・CAD・3Dモデリングをするなら指置き型一択です。

②疲れにくさ・腱鞘炎対策

長時間作業では指置き型が有利。ただし腱鞘炎の部位による。

親指型の注意点：

親指でボールを操作するため、長時間使うと

親指の付け根（母指球）に負担が集中します。

これが「ドケルバン病（親指側の腱鞘炎）」につながる場合があります。

指置き型のメリット：

人差し指・中指・薬指と複数の指で分散して操作するため、

1本の指への集中負荷がありません。

腱鞘炎持ちには、指置き型の方が安心です。

ただし、どちらのタイプも「手首をほとんど動かさない」という点は同じ。
手首の痛み（手根管症候群）には、どちらでも効果があります。

腱鞘炎対策については 【腱鞘炎に悩む人へ】トラックボールで手首の痛みが消えた話 で詳しく解説しています。

③マウスからの移行しやすさ

親指型が圧倒的に有利。

親指型は普通のマウスに近い形です。

【親指型を初めて使ったとき】
「あ、マウスと同じ感覚だ」
→ 1〜3日で慣れる

【指置き型を初めて使ったとき】
「え、どこに手を置けばいいの？」
「人差し指でボールを転がすの？慣れない...」
→ 1〜2週間かかることも

初めてトラックボールを試すなら、

まず親指型から始めることを強くおすすめします。

④価格帯

「まず試してみたい」なら親指型が断然リーズナブル。

Logicool M575S（¥6,000台）なら品質と価格のバランスが最高です。

⑤持ち運びやすさ

親指型が有利。

親指型はコンパクトな製品が多く、カバンに入れやすい。

指置き型は大型製品が多く、デスク据え置き専用になりがちです。

カフェや出張でも使いたい → 親指型
デスクに固定して使う   → どちらでもOK

結論：あなたはどっちを選ぶべき？

ユーザー別おすすめフロー

初めてトラックボールを使う？
  → YES → 【親指型】（M575Sが定番入門機）
  → NO（トラックボール経験あり）
           ↓
    精密作業が多い？（デザイン・動画編集・CAD）
      → YES → 【指置き型】（HUGE または Expert Mouse）
      → NO
               ↓
        親指の付け根が痛い？（腱鞘炎）
          → YES → 【指置き型】（親指への負荷をゼロに）
          → NO → 【親指型上位機】（MX ERGO S）

一言まとめ

「とりあえずどちらか迷ったら親指型。精密作業が多いなら指置き型。」

どちらが「絶対に優れている」わけではありません。

目的と状況で選んでください。

親指型おすすめ商品

Logicool ERGO M575S【迷ったらこれ一択】

価格帯：¥6,000台

✅ 定番中の定番

✅ 電池最大24ヶ月の異常な長持ち

✅ Logicool Optionsで高度なカスタマイズ

❌ 角度調整なし

❌ 充電式ではない

Logicool ERGO M575SP【静音版・最新モデル】

価格帯：¥8,000台

✅ M575Sの静音版

✅ 最新Logi Bolt対応

❌ M575Sより¥2,000高い

Logicool MX ERGO S【親指型の最高峰】

価格帯：¥17,000台

✅ 角度調整機能が革命的

✅ 充電式（1分充電で24時間）

✅ 2台のPCをシームレスに切り替え

❌ 価格が高い

❌ 重め（約260g）

ELECOM EX-G M-XT3DRBK【日本メーカー・コスパ重視】

価格帯：¥4,000台

✅ ¥4,000台で試せる低価格

✅ 6ボタン・横スクロール付き

✅ 日本メーカーの安心感

❌ Bluetooth非対応

指置き型おすすめ商品

ELECOM HUGE M-HT1DRBK【指置き型の入門機として最適】

価格帯：¥10,000台

✅ 52mm大玉で精密操作

✅ 8ボタンで豊富なカスタマイズ

✅ 低反発パームレスト付きで手首が楽

❌ 本製品（M-HT1DRBK）は有線のみ（ワイヤレスモデルは別途存在）

❌ サイズが大きい（持ち運び不可）

Kensington Expert Mouse Wireless【定番の指置き型・長期愛用者続出】

価格帯：¥15,000〜20,000台

✅ 「10年使ってる」ユーザーが続出する信頼性

✅ 55mm大玉で圧倒的な精密操作

✅ スクロールリングの操作感が快感

✅ 5年保証

❌ 角度が固定（手首が痛くなる声も）

❌ 見た目がやや古い

よくある質問

Q1. 親指型から指置き型に後から変えることはできる？

A. できます。ただし慣れ直しに1〜2週間かかります。

親指型に慣れた後に指置き型に移行する場合、

最初は「使いにくい」と感じるはずです。

でも1〜2週間我慢すると、指置き型の精密さに感動するはず。

特に画像編集・動画編集をする人は、移行する価値があります。

Q2. 左利きはどちらが向いている？

A. 指置き型が有利です。

親指型：ほぼ全製品が右利き専用設計
  → 左利きが使える製品はごく少数

指置き型：左右対称設計が多い
  → 左利きでも右利きでもOK

左利きの人には、

ELECOM HUGE や Kensington Expert Mouse のような指置き型をおすすめします。

Q3. MX ERGO S は親指型なのに高いのはなぜ？

A. 充電式・角度調整・2台接続など付加価値が多いからです。

M575Sが「親指型の完成形入門機」なら、

MX ERGO Sは「親指型の最高峰・全部入り」です。

M575S との違い：
✅ 角度調整（0°/20°）→ 手首への負担が劇的に減る
✅ USB-C充電式 → 電池交換不要
✅ 2台同時接続 → 会社PCと自宅PCを1台でカバー
✅ 静音性80%UP

ただし「M575Sで十分」という声も多いので、

まずM575Sを使ってみてから判断するのがおすすめです。

まとめ

親指型を選ぶべき人：

✅ 初めてトラックボールを使う
✅ マウスに近い感覚がいい
✅ 持ち運んで使いたい
✅ 予算¥6,000台で始めたい → M575S
✅ 腱鞘炎（手首側）の改善を目指す

指置き型を選ぶべき人：

✅ 画像編集・動画編集・CADが多い
✅ すでにトラックボール経験がある
✅ 親指の付け根が痛い（ドケルバン病）
✅ 精密操作を最優先にしたい
✅ デスク据え置きでOK

迷ったら、こう決める

「今までマウスを使っていて初めてのトラックボール」

→ Logicool ERGO M575S（親指型・¥6,000台）

「トラックボールを試したことがある・精密作業が多い」

→ ELECOM HUGE（指置き型・¥10,000台）

どちらにしても、

「2週間使えば手放せなくなる」

のがトラックボールの魔力です。

関連記事

• 【なぜ戻れない？】トラックボールマウスの中毒性がヤバい｜初心者向け完全ガイド - 全14機種の比較
• 【腱鞘炎に悩む人へ】トラックボールで手首の痛みが消えた話 - 腱鞘炎対策の詳細ガイド
• 【M575から卒業】トラックボール上位機種を徹底比較 - 上位機種への乗り換えガイド
• 【作業効率3倍UP】マルチモニター×トラックボールで実現する最強デスク環境 - デスク環境全体の最適化

最終更新日: 2026年6月14日
価格は執筆時点の目安です

The post 【親指型 vs 指置き型】トラックボールはどっちを選ぶ？タイプ別完全比較ガイド first appeared on CayTech Lab.

在宅ワーク3年目。

1日8時間以上のPC作業。

右手首に慢性的な鈍痛。

整形外科に行ったら、

「腱鞘炎です。マウスの使いすぎが原因です。」

「じゃあどうすればいいんですか？」

「なるべく手首を休ませてください」

...休ませるって、仕事してるんですけど。

そんなとき、同僚が使っていた謎の機器が目に入りました。

「それ何ですか？」

「トラックボール。腱鞘炎にいいですよ」

半信半疑で試してみた。

3ヶ月後、手首の痛みが消えていました。

今回は、腱鞘炎でお悩みの方に向けて、トラックボールの効果と選び方を徹底解説します。

手首が痛い...その原因、マウスかもしれない

普通のマウスが腱鞘炎を引き起こす仕組み

普通のマウスを使うとき、何が起きているか考えたことありますか？

カーソルを右に動かす
  → 手首・前腕を右に水平移動
  → またカーソルを左に動かす
  → 手首・前腕を左に水平移動

1時間でこの動作を何百回繰り返すでしょう？

1日8時間なら、何千回もの反復動作。

これが腱鞘炎の原因です。

腱鞘炎は「反復動作による過負荷」で起きます。

整形外科・リハビリクリニックでも

「マウス操作によって手根管内圧が上昇する」

と説明されています。

手首を中立位に保つことが保存療法の基本。

しかし普通のマウスを使い続ける限り、中立位を保つのは難しい。

こんな症状が出たら危険サイン

以下の症状、心当たりはありませんか？

❗ マウスを使った後、手首がじんじんする

❗ 朝起きると指がこわばっている

❗ マウスのクリックのたびに痛みを感じる

❗ 親指の付け根が痛い（ドケルバン病の可能性）

❗ 夜中に手のしびれで目が覚める

3つ以上当てはまるなら、今すぐマウスを変えることを検討してください。

トラックボールが腱鞘炎に効く理由

手首を動かさない = 負担がほぼゼロ

トラックボールの革命的な点は、手首を動かさないことです。

【普通のマウス】
カーソル移動 = 手首・前腕を動かす
→ 1日何千回も反復動作
→ 腱鞘炎の原因

【トラックボール】
カーソル移動 = 指でボールを回すだけ
→ 手首は固定・中立位を保てる
→ 腱鞘炎の予防・改善

手首が動かない。

これだけで、腱鞘炎の根本原因が取り除かれます。

医療・エルゴノミクスの根拠

「本当に効果あるの？」

と思いますよね。

Logicool公式のエルゴノミクス研究：

ERGO M575シリーズは人間工学専門家の認定を受けており、

「前腕の筋肉緊張を25%軽減」

という測定値が公式に示されています。

また整形外科・リハビリ分野でも

「手首を中立位に保つ姿勢」が腱鞘炎の保存療法として推奨されています。

トラックボールは、手をデバイスの上に置くだけ。

5本の指をリラックスさせたまま操作できます。

グリップを維持する必要がない = 長時間の蓄積疲労が軽減。

選び方：腱鞘炎の部位でタイプが変わる

2タイプの違いを理解する

トラックボールには大きく2種類あります。

腱鞘炎の部位で選ぶ

重要な注意点があります。

腱鞘炎には種類があります。

手首側（手根管症候群）に痛みがある人：

→ どちらのタイプでも効果的

手首を動かさなければOK。親指型でも指置き型でもOK。

親指の付け根付近が痛い人（ドケルバン病）：

→ 指置き型を選ぶ

親指型は親指でボールを操作するため、ドケルバン病には逆効果になる場合があります。

人差し指・中指操作型を選んでください。

あなたの痛みの場所は？

【手首〜前腕が痛い】
  → 親指型でも指置き型でもOK
  → 初心者は親指型が移行しやすい

【親指の付け根〜親指が痛い（ドケルバン病疑い）】
  → 指置き型（人差し指・中指操作）を選ぶ
  → Kensington SlimBlade Pro や ELECOM HUGE

腱鞘炎対策おすすめトラックボール5選

📊 全機種比較表

Logicool ERGO M575S【腱鞘炎改善の定番入門機】

価格帯：¥6,000台

腱鞘炎対策としての評価：

✅ Logicool公式「前腕の筋肉緊張25%軽減」認定

✅ 手首を固定したまま操作できる基本性能

✅ 初めてのトラックボールとして移行ハードルが低い

❌ 親指の付け根が痛い人には向かない場合あり

❌ 手首の角度調整機能なし

こんな人におすすめ：

• 初めてトラックボールを試したい腱鞘炎持ち
• 予算を抑えたい
• 手首・前腕の痛みが主な悩み

Logicool ERGO M575SP【静音版・2024年刷新】

価格帯：¥8,000台

M575Sとの違い：

• クリック音が80%静音化
• 最新Logi Bolt（電波干渉に強い）対応
• 2024年刷新版で品質向上

こんな人におすすめ：

• 静かなオフィス・テレワーク環境
• 夜中に作業することが多い
• M575Sより少し品質を上げたい

Logicool MX ERGO S【腱鞘炎対策の最高峰・角度調整機能付き】

価格帯：¥17,000台

腱鞘炎対策の観点から見た最大の差別化：

【角度調整機能】

0°：フラット（通常のマウスに近い）
  ↓
20°：手首が自然に「親指が上を向く」角度に

この20°の傾きが、手首の中立位を保つ。
腱鞘炎対策として絶大な効果。

✅ 手首角度調整で負担を最小化

✅ 静音性（M575比80%削減）

✅ 充電式で電池交換不要

✅ 2台のPCを切り替えて使える

❌ 価格が高い（¥17,000台）

❌ 重め（約260g）

「本格的に腱鞘炎を改善したい」なら最初からこれを選んでも後悔しません。

ELECOM EX-G M-XT3DRBK【日本メーカー・コスパ重視】

価格帯：¥4,000台

こんな人におすすめ：

• とにかく安く試したい（¥4,000台）
• 日本メーカー品がいい
• まず「腱鞘炎に効くか試してみたい」

❌ Bluetooth非対応

❌ ボールの滑りはM575に劣る

Kensington SlimBlade Pro【親指に痛みがある人の最有力候補】

価格帯：¥12,000台

親指が痛い人に特におすすめの理由：

親指型トラックボールで症状が改善しない場合、

それは**ドケルバン病（親指側の腱鞘炎）**の可能性があります。

その場合、指置き型に切り替えることで

親指への負荷がゼロになります。

SlimBlade Proは55mm大玉を

人差し指・中指・薬指の複数指で操作する設計。

少ない動きで広い範囲をカバーできます。

✅ 親指への負荷ゼロ

✅ 55mm大玉で少ない動きで広範囲を移動

✅ 回転スクロールが快適

✅ 薄型フラットで手首への負担も少ない

よくある質問

Q1. トラックボールに変えたら本当に腱鞘炎が治る？

A. 「治る」ではなく「悪化を防ぎ、改善を助ける」です。

腱鞘炎は炎症なので、まず安静が最優先。

トラックボールは「マウス使用時の手首への負担を減らす」ものです。

ひどい腱鞘炎の場合は整形外科の受診を。

軽症〜中等症なら、トラックボールへの切り替えで改善するケースが多いです。

私の場合も、整形外科での治療と並行してトラックボールに切り替え、

3ヶ月で痛みがほぼ消えました。

Q2. 慣れるまでどのくらいかかる？

A. 1〜2週間です。

最初の3日は「使いにくい...」と感じます。

1週間で普通に使えるようになります。

2週間で「もう普通のマウスには戻れない」と感じるようになります。

腱鞘炎改善のための投資として、2週間の慣れ期間は十分価値があります。

Q3. 既にひどい腱鞘炎でも使える？

A. 使えますが、まず医師に相談を。

重度の腱鞘炎の場合は、どんなデバイスを使っても悪化するリスクがあります。

整形外科でのステロイド注射や手術が必要な場合もあります。

軽〜中程度なら、トラックボールへの切り替えは有効な選択肢です。

Q4. リストレストと組み合わせると効果的？

A. はい、特に指置き型には有効です。

指置き型（Kensington など）は手首の角度が固定されやすいため、

社外品のゲルタイプのリストレストとの組み合わせで

さらに手首への負担を減らせます。

まとめ：腱鞘炎持ちには「まずM575S」から

手首・前腕の痛みが主な悩み、コスパ重視
  → Logicool ERGO M575S（¥6,000台）

静かな環境で使いたい、最新モデルがいい
  → Logicool ERGO M575SP（¥8,000台）

本気で腱鞘炎を改善したい、予算があれば
  → Logicool MX ERGO S（¥17,000台）

親指の付け根〜親指が痛い（ドケルバン病疑い）
  → Kensington SlimBlade Pro（¥12,000台）

とにかく安く試したい
  → ELECOM EX-G M-XT3DRBK（¥4,000台）

最後に

腱鞘炎は放置すると慢性化します。

私は最初「たかが手首の痛み」と思って放置していました。

半年後には手術を勧められる寸前まで悪化。

「早く気づいてよかった」

今は毎日思っています。

トラックボールは数千円〜数万円の投資。

でも腱鞘炎の治療費（整形外科通院、物理療法、場合によっては手術）と比べたら？

腱鞘炎治療費の目安：
  整形外科受診：¥3,000〜5,000/回
  物理療法：¥1,000〜2,000/回
  通院回数：週2回 × 3ヶ月 = 24回
  合計：¥96,000〜168,000

予防にトラックボール：¥6,000〜17,000

圧倒的にコスパの良い「健康への投資」です。

今の手首の痛み、放置していませんか？

関連記事

• 【なぜ戻れない？】トラックボールマウスの中毒性がヤバい｜初心者向け完全ガイド - トラックボール入門者向け全機種比較14選
• 【親指型 vs 指置き型】トラックボールはどっちを選ぶ？タイプ別完全比較ガイド - 2タイプの違いを詳しく解説
• 【M575から卒業】トラックボール上位機種を徹底比較 - M575から上位機種へのアップグレードガイド
• 【作業効率3倍UP】マルチモニター×トラックボールで実現する最強デスク環境 - デスク環境全体の最適化

最終更新日: 2026年6月14日
価格は執筆時点の目安です

The post 【腱鞘炎に悩む人へ】トラックボールで手首の痛みが消えた話｜選び方と効果を徹底解説 first appeared on CayTech Lab.

答えは明確です。

「全く後悔していません。むしろ、もっと早く買えばよかった」

ただ、2年使って初めてわかった「本音」もあります。

「こういう人には合わない」という事実も包み隠さず話します。

レビュー記事に多い「良いことしか書いてない」記事ではなく、

2年間の実体験からわかった全てをお伝えします。

Logicool ERGO M575 とは？

一言で言うと

「トラックボール入門機の定番中の定番」

Logicoolが出しているトラックボールの中で、

最もコスパが良くて、最も売れている機種。

「はじめてのトラックボール」として

**「迷ったらM575」**と言われるほどの信頼性があります。

詳細スペック

カラーバリエーション

M575には3つのバリエーションがあります。

重要な違い：M575Sは保証が1年（他の2モデルは2年）

価格差が¥1,000〜2,000程度なら、M575GRかM575OWを選んだ方が安心です。

実際に2年使ってわかった感想

最初の1週間

正直に言います。

1日目：「全然使えない...マウスの方が良かった」
2日目：「ちょっとだけ慣れてきた気がする」
3日目：「クリックとホイール操作は慣れた。カーソル操作がまだ難しい」
5日目：「あ、普通に使えるようになってきた」
7日目：「もう普通に仕事で使えてる」

1週間で普通に使えるようになりました。

その後は早かった。

1ヶ月後

「普通のマウスに戻れなくなった」

会社のPCでマウスを使ったとき、

「なんで腕をこんなに動かさなきゃいけないんだ...」

と感じました。

これがトラックボール中毒の始まりです。

2年後（現在）

「M575なしでは生きていけない」

大げさに聞こえるかもしれませんが、

1日8時間のPC作業で、右手首への負担が激減しました。

特に実感したのは：

✅ 手首の疲れがほぼゼロになった

✅ マルチモニター環境が快適になった（ボールを弾くだけで画面間を移動）

✅ 集中力が続くようになった（疲れによる集中力低下がなくなった）

M575 のメリット・デメリット

メリット

✅ 手首への負担が激減

普通のマウス：腕・手首を動かす → 疲れる
M575：ボールを指で転がすだけ → 腕は動かさない

✅ 電池が異常に長持ち（最大24ヶ月）

購入して最初の電池交換：約20ヶ月後
電池を交換した後の感想：「まだ切れてなかったのか」

✅ 省スペース・マウスパッド不要

狭いデスクでも使える
ソファでも布団の上でも使える
カフェの狭いテーブルでも使える

✅ Logicool Options でカスタマイズ可能

戻るボタン → ブラウザバック
進むボタン → コピー（Ctrl+C）
DPIボタン → 画像編集時に高精度モードへ切替

✅ Bluetooth と Unifying の2接続対応

会社PC → Unifyingレシーバーで接続
自宅PC → Bluetoothで接続
→ ボタン1つで切り替え可能（※M575は同時接続1台まで。2台切り替えはMX ERGO S）

デメリット

❌ 慣れるまで1週間かかる

最初の3〜5日は「使いにくい」と感じる
諦めずに1週間使い続けることが重要

❌ 細かいドラッグ操作が苦手

Excelで範囲選択：微妙にずれる
Photoshopで精密な選択：難しい
CADで細かい操作：限界を感じる
→ 精密作業が多い人は指置き型（ELECOM HUGE等）を検討

❌ 手首の角度調整ができない

M575は固定角度
「もう少し傾けたい」と思うことがある
→ MX ERGO Sなら0°/20°の2段階調整可能

❌ クリック音がやや大きい

静かなオフィスでは気になる
→ 静音版のM575SPを検討

❌ 充電式ではない（電池式）

充電式が好きな人には不便
ただし最大24ヶ月持つので実害は少ない
→ 充電式が欲しいなら MX ERGO S

前モデル M570 との違い

M570 から乗り換えを検討している人向けです。

M570ユーザーは迷わずM575に乗り換えを。

ボールの滑らかさが別次元に改善されています。

M575 vs MX ERGO S

M575を使い始めると、次に気になるのが上位機種の「MX ERGO S」です。

M575で十分な人

✅ コーディング・文書作成が中心
✅ 予算を抑えたい
✅ 軽いマウスが好き
✅ 電池を管理したくない（24ヶ月持つので忘れてOK）

MX ERGO S が必要な人

✅ 手首の角度調整で腱鞘炎を改善したい
✅ 2台のPCを頻繁に切り替えて使う
✅ 充電式にこだわる
✅ 静かなオフィスで使う

重要な真実：多くのレビュアーが「M575で十分、むしろ使い勝手はM575の方が良い」と言っています。

MX ERGO Sは重いので、長時間使用では逆に疲れるという声も。

上位機種については 【M575から卒業】トラックボール上位機種を徹底比較 で詳しく解説しています。

M575 vs ELECOM EX-G

同価格帯の対抗馬との比較です。

「Bluetoothが必要かどうか」が分岐点。

Bluetooth不要なら ELECOM EX-G の方がボタン数が多くてコスパが高い。

Bluetoothで複数デバイスに対応したいなら M575 一択。

M575 を買うべき人・買わない方がいい人

買うべき人

✅ トラックボールを初めて試す人

✅ 手首・肩・腕の疲れを改善したい人

✅ 省スペースで作業したい人

✅ 文書作成・ブラウジング・プログラミングが中心の人

✅ 電池を交換し続けても気にしない人

✅ 「とにかく失敗したくない」人（M575は外れなし）

買わない方がいい人

❌ 画像編集・動画編集・CADが中心の人

→ 指置き型（ELECOM HUGE 等）の方が精密操作に向いている

❌ 親指の付け根が痛い人（ドケルバン病）

→ 親指型は逆効果になる場合あり。指置き型を選ぼう

❌ 充電式にこだわる人

→ MX ERGO S へ

❌ 手首の角度調整がしたい人

→ MX ERGO S へ

カラー・モデル選び方ガイド

どのモデルを選ぶべきか

1. まずは M575GR（グラファイト）を選ぶのが無難

理由：

• 2年保証
• 落ち着いた色で飽きにくい
• デスクに馴染みやすい

2. M575OW（オフホワイト）はデスクが明るい人向け

ホワイト系のデスクや白いモニターと合わせると映える。

環境配慮設計（再生プラスチック21%使用）もポイント。

3. M575S（ブラック）はコスト最優先のみ

保証が1年な点に注意。¥1,000〜2,000の価格差を惜しまないなら M575GR を選ぶべき。

まとめ：M575は「買って後悔しない」保証付きの1台

私の結論

2年間、毎日使い続けてわかったこと。

M575は「トラックボール入門機として完璧」です。

良いところ：
✅ 手首への負担が激減
✅ 電池24ヶ月でほぼメンテフリー
✅ Logicool品質の信頼性
✅ 価格¥6,000台で入門しやすい
✅ 1週間で慣れる

悪いところ：
❌ 精密作業には限界
❌ 角度調整なし
❌ クリック音やや大きめ

でも、**「デメリットを上回るメリット」**があります。

1日8時間のPC作業が、

圧倒的に楽になる。

数千円の投資で、

残りの仕事人生が変わる。

試してみませんか？

あなたの状況別おすすめ

初めてのトラックボール、失敗したくない
  → M575GR（グラファイト）一択

白いデスク環境、インテリアを統一したい
  → M575OW（オフホワイト）

コスト最優先、1年以内に壊れたら買い替えでOK
  → M575S（Amazon限定・ブラック）

静音性が欲しい、最新モデルが良い
  → M575SP（静音版・後継モデル）

角度調整・充電式・2台接続が欲しい
  → Logicool MX ERGO S（上位機種）

関連記事

• 【なぜ戻れない？】トラックボールマウスの中毒性がヤバい｜初心者向け完全ガイド - M575を含む14機種の比較
• 【M575から卒業】トラックボール上位機種を徹底比較 - M575の次の1台を探すガイド
• 【親指型 vs 指置き型】トラックボールはどっちを選ぶ？ - 操作タイプの選び方
• 【腱鞘炎に悩む人へ】トラックボールで手首の痛みが消えた話 - 腱鞘炎対策としてのトラックボール

最終更新日: 2026年6月14日
価格は執筆時点の目安です

The post Logicool ERGO M575 完全レビュー｜2年使ってわかった本音と真実 first appeared on CayTech Lab.

「あなたのキーボード音、ちょっとうるさいです」

画面越しに言われた、あの瞬間。

恥ずかしい。でも止められない。

仕事中にタイピングしないわけにいかない。

しかも在宅だと、家族の目線も気になります。

深夜に作業していて「うるさくて眠れない」と言われた経験、ありませんか？

私はありました。

それをきっかけに、静音メカニカルキーボードを真剣に調べ始めました。

調べていくうちに気づいたこと。

「静音」と書いてあっても、全然静かじゃないものがある。

本当に静かなのは、スイッチの設計とボディ構造が両方揃っているモデルだけでした。

この記事では、その「本当に静かなモデル」を厳選して6つ紹介します。

この記事で分かること

• 静音メカニカルキーボードの選び方（静音スイッチ・ガスケット構造・接続方式の違い）
• 2〜5万円帯おすすめ6選の詳細比較
• 用途・シチュエーション別のおすすめ早見表
• ビデオ会議・深夜作業でも安心して使えるモデルの見つけ方

こんな人におすすめ

• ZoomやTeamsなどビデオ会議中にタイピングする機会が多い人
• 家族と同居しており、深夜の打鍵音が気になっている人
• メカニカルキーボードの打鍵感は欲しいが、音は極力抑えたい人
• 予算2〜5万円で「本当に良いもの」を選びたい人

静音メカニカルキーボードの選び方

商品を見る前に、静音性を左右する3つのポイントを押さえておきましょう。

ここを知っておくだけで、選ぶときの迷いが大幅に減ります。

① スイッチの種類：「サイレント」が付いていないと意味がない

メカニカルキーボードといえば、その独特の打鍵感が魅力です。

でも、普通のメカニカルスイッチはかなりうるさい。

青軸はカチカチと大きな音。赤軸も「スコスコ」という底打ち音があります。

静音を求めるなら、選ぶべきはサイレントスイッチ一択です。

サイレントスイッチには、キーストローク中にダンパー（緩衝材）が付いており、底打ち・跳ね返り時の音を大幅に吸収します。

これがあるかないかで、静音性が全く変わります。

② ボディ構造：「ガスケットマウント」が打鍵音を根本から変える

スイッチだけ静音にしても、ボディの共鳴で音が響くことがあります。

ここで重要なのがガスケットマウント構造です。

ガスケットマウントは、基板とケースの間に**柔らかいシリコンやゴムのクッション材（ガスケット）**を挟む構造です。

打鍵時の振動が直接ケースに伝わらないため、音が柔らかく「こもった」感じになります。

これが「静音メカニカル」の最上位クラスに使われる理由です。

③ 接続方式：在宅ワーカーには「3モード対応」が便利

在宅ワーカーなら、3つすべてに対応しているモデルがもっとも使い勝手が良いです。

朝はPC有線、昼はMacをBluetooth、Zoomのときは2.4GHz……という使い方ができます。

【2〜5万円】静音メカニカルキーボードおすすめ6選

価格帯の低い順に紹介します。

第1位：Logicool MX Mechanical Mini（KX850CL）｜ビデオ会議に最適な静音コンパクト

価格: 約17,000〜22,000円（税込）

こんな人に最適

「Zoomで打鍵音を指摘された」「デスクを広く使いたい」という在宅ワーカーに一番おすすめしたい1台です。

サイレントリニアスイッチはキーを押した際の底打ち音・跳ね返り音がほぼありません。Logi Bolt（2.4GHz）接続時の安定性は抜群で、ビデオ会議中の入力も快適。

テンキーレスでマウスとの距離が縮まり、長時間作業でも肩が疲れにくくなります。

正直なデメリット

• テンキーが必要な人には物足りない（フルサイズモデルは次で紹介）
• Logi Bolt非対応PCでBluetoothのみ使う場合、接続安定性がやや劣ることも
• ガスケット構造ではないため、Keychron系と比べると打鍵音の「柔らかさ」は控えめ

第2位：Logicool MX Mechanical（KX850FL）｜テンキー付きでも静音を諦めない

価格: 約20,000〜25,000円（税込）

こんな人に最適

経理・データ入力などテンキーを頻繁に使う仕事をしている在宅ワーカーに最適です。

MX Mechanical Miniと同じサイレントスイッチを搭載しているため、静音性は同等。「コンパクトにしたくない」「テンキーは絶対必要」という方はこちらを選んでください。

フルサイズでもLogi Boltによる2.4GHz接続で安定したタイピングが可能です。

正直なデメリット

• フルサイズなのでデスク占有面積が増える
• Miniと比べてデスクとマウスの距離が遠くなり、肩への負荷が増す場合がある
• ガスケット構造ではないため、高級感のある打鍵音を求める人は物足りないかも

第3位：Keychron Q1 Pro｜ガスケット×サイレントで別次元の静音性

価格: 約25,000〜28,000円（税込）

こんな人に最適

「本当に静かなメカニカルキーボードが欲しい。打鍵感にも妥協したくない」という方はここから選ぶべきです。

フルアルミのガスケットマウントボディ＋Gateron G Proサイレントスイッチの組み合わせは、打鍵音の質が根本的に違います。底打ちしてもケースに音が響かず、「スッ」と静かに収まる感覚。

ホットスワップ対応なので、スイッチを別のサイレント系に換装して自分好みの打鍵感を追求できます。QMK/VIA対応でキーマップも自由にカスタマイズ可能。

正直なデメリット

• 2.4GHzドングル非対応（BluetoothかUSB-C有線のみ）
• 英語配列中心のため、日本語配列に慣れた人は記号キーの位置に戸惑う
• 重量があるため持ち運びには向かない

第4位：Keychron Q3 Pro / Q3 Max｜TKLレイアウト×3接続で万能静音機

価格: 約24,000〜30,000円（税込）

こんな人に最適

「テンキーレスで省スペースに使いたい。でもF列は欲しい」「複数の接続方式を使い分けたい」という方に向けた1台です。

Q1 Proが75%レイアウトなのに対し、Q3はTKL（80%）レイアウト。F列とDeleteキー周辺の配置が標準的で、乗り換えたときの違和感が少ないのが特徴です。

Q3 Maxを選べば2.4GHz接続にも対応。ビデオ会議中の入力で安定性を求めるなら、Maxシリーズがお買い得です。

正直なデメリット

• Q3 MaxはQ3 Proより価格帯がやや高め
• 日本語（JIS）配列モデルの入手がしにくい場合がある
• 英語配列に不慣れな場合は初期設定や記号入力に慣れが必要

第5位：NuPhy Air75 V3｜ロープロファイルで疲れにくい・日本語配列あり

価格: 約25,740〜28,600円（税込）

こんな人に最適

「ノートPCに近い打鍵感が好き」「日本語配列で静音メカニカルを探している」という方への答えがここにあります。

ロープロファイルスイッチはキーストロークが浅く、手首の角度が自然なため長時間作業でも疲れにくいのが特長。Blush nano サイレントスイッチはタクタイル（軽いクリック感）でありながら、音は十分に抑えられています。

4台のBluetooth接続＋2.4GHz対応で、複数デバイスを切り替えながら使う在宅ワーカーに最適です。

正直なデメリット

• ロープロファイルが好みでない方（しっかりした打鍵感を求める方）には物足りないかも
• ガスケットマウントではないため、Keychron系と比べると打鍵音の吸収感は控えめ
• Keychron QシリーズほどQMK/VIAのカスタマイズ自由度は高くない

第6位：Keychron Q6 Max｜在宅ワークの最高到達点。静音フルサイズの頂点

価格: 約43,890円（税込）

こんな人に最適

「予算はある。最高の1台が欲しい。」そういう方のためのキーボードです。

ダブルガスケットマウント（ガスケットが2重）＋サイレントスイッチ＋フルアルミCNCボディの組み合わせは、静音性・打鍵感・質感すべてにおいてトップクラス。

テンキー付きフルサイズなのに、このクラスの静音性を実現しているモデルは他にほとんどありません。

3接続方式対応なので、有線・Bluetooth・2.4GHzを状況に応じて使い分けられます。「一生使えるキーボード」を求めるなら、これが答えです。

正直なデメリット

• 価格が5万円弱と、気軽に手を出しにくい
• フルアルミボディは高品質ですが、重量がかなりあるため持ち運びには不向き
• 英語配列中心のため、日本語配列に慣れた方は注意が必要

用途別おすすめ早見表

迷ったときはこの表を参考にしてください。

価格帯別まとめ

まとめ｜在宅ワークに静音メカニカルキーボードを選ぶ理由

改めて、静音メカニカルキーボードが在宅ワーカーに必要な理由を整理します。

メカニカルの打鍵感は、長時間作業での疲れ方が違います。

適度な反発と滑らかさで、指への負荷が軽減される。

これはメンブレンでは味わえない感覚です。

でも普通のメカニカルはうるさい。

ビデオ会議中に相手に指摘される。家族に怒られる。深夜に使えない。

そういう問題が、サイレントスイッチ＋ガスケット構造で解決します。

この記事で紹介した6選は、それぞれ用途や価格に応じた「最適解」を選んでいます。

まずは予算と使い方を確認して、自分に合った1台を見つけてください。

静音メカニカルキーボードに替えた翌日のZoom。

「あれ、キーボード音しなくなりましたね」と言われる。

あの瞬間の達成感、ぜひ味わってください。

関連記事

• まずキーボードの基本を知りたい方はこちら
• デスク環境全体を整えたい方はこちら
• マウスも一緒に見直したい方はこちら

The post 在宅ワーカー向け静音メカニカルキーボードおすすめ6選【2〜5万円・2026年版】 first appeared on CayTech Lab.

「PCに付属してたやつで十分でしょ」

「全部キーボードって同じじゃないの？」

私も最初はそう思っていました。

でも、ちゃんと選んだキーボードに替えた瞬間、考えが変わりました。

「あれ、タイピングってこんなに気持ちいいの？」

「疲れにくくなった気がする」

「仕事のやる気が上がった（笑）」

キーボードは毎日何千回も触れる道具です。

適当に選んで後悔するより、最初からちゃんと選んだほうが絶対にいい。

この記事では、1万円以下・コスパ重視・タイピング初心者向けに厳選した6モデルを徹底比較します。

この記事で分かること

• キーボードの基本的な選び方（接続方式・スイッチの種類）
• 1万円以下おすすめ6選の詳細比較
• 用途・目的別のおすすめ早見表
• 初心者が陥りがちな失敗と回避法

こんな人におすすめ

• PCキーボードを初めて買う人
• 付属品・激安品から卒業したい人
• 予算1万円以内でできるだけ良いものが欲しい人
• ワイヤレス・静音・メカニカルなど気になるキーワードがある人

まず知っておきたい選び方の基本

商品を見る前に、3つの基本を押さえておくと迷いが減ります。

① 接続方式：有線 vs ワイヤレス

初めての1台なら有線がトラブルが少なくておすすめです。

② キースイッチ：打鍵感の核心

初心者はメンブレンから入るのが無難です。使ってみてカチカチが気になり始めたら、メカニカルへの移行を検討するのが自然な流れです。

③ 配列：日本語 vs 英語

タイピング初心者は迷わず日本語（JIS）配列を選んでください。

英語配列は記号キーの位置が大きく異なるため、日本語入力に慣れた状態から切り替えると混乱します。

【1万円以下】コスパ最強キーボード6選

価格帯の低い順に紹介します。

第1位：BUFFALO BSKBU105BK｜とにかく安く始めたい人の最終兵器

価格: 約1,000円（税込）

こんな人に最適
「とりあえず使えればいい」「予備・サブ機が欲しい」人の最適解。1,000円以下で買えてテンキー付き・レーザー刻印（文字が消えにくい）・水抜き穴と、必要なものは一通り揃っています。

正直なデメリット

• 本体のガタつきが気になる
• メンブレン特有の硬めの反発で長時間使用は疲れやすい
• デザイン・質感はチープ

Amazonレビュー評価: ★3〜4

第2位：Logicool K120｜有線定番・迷ったらこれ

価格: 約2,000円（税込）

こんな人に最適
Amazonのキーボードカテゴリで長年ベストセラー常連の理由があります。「安くて長持ち・挿すだけで使える」シンプルさが最大の強み。法人・オフィスでの大量導入実績もあり、信頼性は折り紙付きです。

正直なデメリット

• 打鍵音が「カタカタ」と大きめ（静音派には不向き）
• 本体が軽すぎてズレやすい
• 長年使うと印字が薄くなる

Amazonレビュー評価: ★4.0〜4.2（2,900件超）

第3位：ELECOM TK-FBP102｜複数デバイス派のBluetoothエントリー

価格: 約2,500円（税込）

こんな人に最適
PCだけでなくiPadやスマホでも使いたい、複数デバイスを持ち歩いている人向け。ボタン1つで3台の切り替えができ、薄さ6.5mmで鞄に入れても邪魔になりません。

正直なデメリット

• テンキーレスのため数字入力が多い人には不便
• プラスチック感が強くキーが経年でゆるくなることも
• 一部キーの配置がやや変則的で慣れが必要

Amazonレビュー評価: ★3.7（3,400件超）

第4位：Logicool K295｜ワイヤレス静音の最高コスパ

価格: 約3,000〜3,500円（税込）

こんな人に最適
「有線は嫌だ・でも高いのも嫌だ」という人のベストアンサー。3,000円台でワイヤレス・静音（従来比90%削減）・テンキー付きフルサイズがすべて揃います。電池は最大24ヶ月と管理も楽。在宅ワーカーに特におすすめの1台です。

Amazonレビューでよく見る声

「値段の割に静かすぎる」「コスパ最高」「テンキーがついているのに安い」

正直なデメリット

• テンキー付きフルサイズのためコンパクト派には向かない
• メンブレンのため「打っている感触」は薄め

Amazonレビュー評価: ★4.4（400件超）

第5位：Logicool G213r｜仕事もゲームも兼用したい人の最適解

価格: 約7,000円（税込）

こんな人に最適
ゲームもやるし仕事でも使いたい人向け。約7,000円でRGBライティング・一体型パームレスト・静音スイッチがすべて入ってくる破格のコスパ。初めてのゲーミングキーボードとして、失敗しにくい1台です。

正直なデメリット

• パームレスト一体型フルサイズでデスクを広く占有
• RGBはキーの透明部分のみ発光のため、上位モデルと比べると見劣り

Amazonレビュー評価: ゲーミングキーボードカテゴリでベストセラー常連

第6位：Keychron K2 V2｜1万円以下でメカニカルを体験したい人へ

価格: 約8,000〜9,500円（税込）

こんな人に最適
「いつかはメカニカルを試してみたい」という初心者の最初の1台として、評価が安定しています。有線・ワイヤレス両対応・Mac/Windows両対応で、1台買えばどんな環境でも使えます。

赤軸（リニア・静か）・茶軸（中間）・青軸（カチカチ）の3種類から選べるので、自分の好みに合ったスイッチを選べるのも魅力です。

正直なデメリット

• 75%レイアウトのためテンキーなし、F列は一部Fnキーとの組み合わせ
• 日本語配列モデルの入手が難しい場合がある

用途別おすすめ早見表

初心者が陥りがちな失敗

「メカニカルキーボード」に憧れて最初から買う
カチカチ・スコスコの打鍵感に憧れるのは自然ですが、初めて使うと「思ってたより音が大きい」「慣れるまで時間がかかる」と感じる人が多いです。まずはメンブレンで1〜2ヶ月使い、それでも気になったらメカニカルへ移行する順序が失敗しにくいです。

「テンキーレスにしたら数字入力が大変だった」
Excelや数値入力が多い人がテンキーレスにして後悔するケースがあります。数字入力が多い場合はフルサイズ（テンキー付き）を選びましょう。

「Bluetooth対応だと思ったら有線専用だった」
商品ページの写真だけ見て購入すると見落としがちなポイントです。接続方式は必ずスペックを確認してください。

まとめ｜1万円以下で自分に合うPCキーボードを見つけよう

最初の1台は「失敗してもダメージが少ない価格帯で試す」がおすすめです。

予算別のおすすめルート：

• 1,000〜2,000円 → BUFFALO か Logicool K120 で試す
• 3,000〜5,000円 → Logicool K295 でワイヤレス体験
• 7,000〜10,000円 → G213r かKeychron でゲーミング・メカニカル体験

キーボードは毎日触れる道具。気持ちよく打てると、それだけで仕事が少し楽しくなります。

「なんとなく付属品を使っていた」から卒業する最初の一歩として、ぜひ参考にしてみてください。

関連記事

• デスク環境の予算別構築ガイド — キーボード以外のデスク環境を整えるならこちら
• マルチモニター×トラックボールで最強デスク環境 — 周辺機器をまとめてアップグレードしたい方はこちら
• トラックボールマウス初心者ガイド — マウスも一緒に見直したい方はこちら

The post PCキーボード初心者向けおすすめ6選【1万円以下・コスパ重視・2026年版】 first appeared on CayTech Lab.

はじめに

VSCodeのメニューバーには、ファイル・編集・選択・表示・移動・実行・ターミナル・ヘルプの8つのプルダウンメニューがあります。しかし、その全てのメニュー項目を把握している方は少ないのではないでしょうか。

本記事では、VSCodeの全プルダウンメニューを階層ごとに完全網羅し、各機能のショートカットキー・使いどころ・おすすめポイントを徹底解説します。

この記事の特徴：

• メニューバーの全8カテゴリを完全網羅
• サブメニューの階層まで詳しく解説
• 実際のメニュー画面に対応した最新情報
• ★マークで特に重要な機能を表示
• 使いどころ・活用シーンを具体的に説明

ファイル(F)メニュー

ファイルの新規作成・保存・設定など、VSCodeの基本操作が集まっています。

新規作成

プロファイルを含む新しいウィンドウ のサブメニュー：

活用ポイント：

• Ctrl+N でまず新規ファイルを開き、保存時に拡張子を決める流れが効率的
• 複数プロジェクトを同時進行する場合は Ctrl+Shift+N で別ウィンドウを活用

ファイルを開く

最近使用した項目を開く のサブメニュー：

ワークスペース管理

保存

共有・設定

ユーザー設定 のサブメニュー：

テーマ のサブメニュー：

ウィンドウ・エディター管理

編集(E)メニュー

テキスト編集の基本操作から、コード特有の編集機能まで揃っています。

元に戻す・やり直し

クリップボード操作

活用ポイント：

• 選択範囲なしで Ctrl+X を押すと行全体が切り取り対象になる
• 選択範囲なしで Ctrl+C を押すと行全体がコピーされる（空行と勘違いしやすい）

検索・置換

Ctrl+Shift+F活用術：

1. Ctrl+Shift+F で検索パネルを開く
2. 検索文字列を入力
3. 「絞り込み」で特定のファイル種類に限定（例: *.ts）
4. 検索結果をクリックで該当箇所にジャンプ

コメント操作

行コメント活用術：

// 単一行のコメントアウト
1. カーソルを対象行に移動
2. Ctrl+/ で即コメントアウト

// 複数行の一括コメントアウト
1. Shift+クリックで複数行を選択
2. Ctrl+/ で一括コメントアウト

選択(S)メニュー

テキスト選択とカーソル操作の高度な機能を提供します。マルチカーソルは特に強力です。

基本選択

選択範囲の展開 活用例：

カーソル位置から Shift+Alt+→ を何度か押すと
単語 → 文 → ブロック → 関数全体... と段階的に拡大
逆に Shift+Alt+← で縮小できる

行の移動・コピー

マルチカーソル（超重要）

マルチカーソル活用例：

// 複数のCSSプロパティに同時に「!important」を追加
1. 対象の複数行を選択
2. Shift+Alt+I で各行末にカーソルを配置
3. " !important" と入力 → 全行に一括追加

出現箇所の選択

Ctrl+D 活用術（変数名の一括リネーム）：

1. 変数名にカーソルを置く
2. Ctrl+D を押すたびに次の同じ単語が選択に追加される
3. 変更したくない箇所は Ctrl+K Ctrl+D でスキップ
4. すべて選択したら新しい名前を入力 → 一括リネーム完了

表示(V)メニュー

VSCodeのUIレイアウトとパネルの表示・非表示を制御します。

コマンドパレット

外観（Appearance）

アクティビティ バーの位置 サブメニュー：

パネルの位置 サブメニュー：

パネルの配置 サブメニュー：

タブ バー サブメニュー：

エディター アクションの位置 サブメニュー：

その他の外観設定：

エディター レイアウト

エディター分割活用術：

// 仕様と実装を並べて表示
1. 仕様ファイルを開く
2. Ctrl+\ で右に分割
3. 右側で実装ファイルを開く
→ 両方を見ながら実装できる

サイドバーパネル

下部パネル

その他

移動(G)メニュー

エディター内・ファイル間・コード定義へのナビゲーションを提供します。

基本移動

エディターの切り替え

グループの切り替え

ファイル・シンボルへの移動

Ctrl+P 活用術：

Ctrl+P を押した後：
test        → ファイル名で検索（fuzzy検索）
@symbol     → 現在ファイルのシンボル検索
#symbol     → ワークスペース全体のシンボル検索
:42         → 42行目にジャンプ
>command    → コマンドパレット（Ctrl+Shift+P と同等）

コード定義への移動

定義移動の効率的な使い方：

1. 関数名にカーソル → F12 で定義に移動
2. Alt+← で元の場所に戻る
3. Alt+F12 でその場でプレビュー（移動しない）

行・ブラケットへの移動

Ctrl+G 活用例：

エラーログ: "error at line 245"
→ Ctrl+G → 245 → Enter → エラー行に直接ジャンプ

問題・変更箇所への移動

実行(R)メニュー

デバッグ実行とブレークポイントの管理を提供します。

デバッグ実行

デバッグ設定

ステップ実行（デバッグ中）

デバッグの基本フロー：

1. F9 でブレークポイントを設定
2. F5 でデバッグ開始
3. F10 でステップ実行（行ごとに確認）
4. 怪しい関数はF11でステップイン
5. 変数をマウスホバーで値を確認
6. F5 で次のブレークポイントに進む
7. Shift+F5 でデバッグ終了

ブレークポイント管理

新しいブレークポイント サブメニュー：

条件付きブレークポイントの活用：

// ループの特定の回数でのみ停止したい場合
条件: i === 100  →  i が100の時だけ停止

// 特定の値の時だけ停止
条件: user.id === "admin"  →  adminユーザーの時だけ停止

ターミナル(T)メニュー

統合ターミナルとタスク実行を管理します。

ターミナル操作

ターミナル活用術：

// 複数の作業を並行する場合
1. Ctrl+Shift+` で新しいターミナルを複数作成
2. ターミナルに名前を付けて区別（右クリック→「名前の変更」）
3. フロントエンド用・バックエンド用・Git用など用途別に使い分け

タスク実行

実行中のタスク管理

タスク設定

tasks.json の基本例：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "npm build",
            "type": "npm",
            "script": "build",
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

ヘルプ(H)メニュー

学習リソース・情報・サポートへのアクセスを提供します。

学習リソース

リリース情報

キーボード・チュートリアル

コミュニティ

法的情報・ツール

メニュー別ショートカットキー早見表

ファイル(F)メニュー

編集(E)メニュー

選択(S)メニュー

表示(V)メニュー

移動(G)メニュー

実行(R)メニュー

ターミナル(T)メニュー

ヘルプ(H)メニュー

よく使うショートカットTOP30

絶対に覚えるべき（★★★）

1. Ctrl+Shift+P - コマンドパレット（全機能の入り口）
2. Ctrl+P - ファイルへ移動（ファイル名検索）
3. Ctrl+S - 保存
4. Ctrl+F - ファイル内検索
5. Ctrl+H - ファイル内置換
6. Ctrl+Shift+F - 横断検索
7. Ctrl+D - 次の一致を選択（マルチカーソル）
8. Ctrl+/ - 行コメントトグル
9. F12 - 定義に移動
10. Alt+← - 戻る（定義移動後の復帰）
11. Ctrl+` - ターミナル表示/非表示
12. F5 - デバッグ開始/続行
13. F10 - ステップ実行

効率を大幅に上げる（★★）

14. Ctrl+Shift+L - 全出現箇所を選択
15. Ctrl+Alt+↑/↓ - マルチカーソル追加
16. Alt+↑/↓ - 行を移動
17. Shift+Alt+↓ - 行を複製
18. Ctrl+B - サイドバートグル
19. Ctrl+Shift+T - 閉じたタブを復元
20. Ctrl+G - 行に移動
21. F8 - 次のエラーに移動
22. Ctrl+1/2 - エディターグループ切り替え
23. Ctrl+PageDown/Up - タブ切り替え
24. F9 - ブレークポイント設定
25. Ctrl+Shift+G - Git操作パネル

カテゴリ別活用シーン

新しいプロジェクトを始める時

1. Ctrl+K Ctrl+O → フォルダを開く
2. Ctrl+Shift+E → エクスプローラーでファイル構造確認
3. Ctrl+N → 新しいファイルを作成
4. Ctrl+S → 保存（ファイル名・拡張子を設定）

コードを読む・調査する時

1. Ctrl+P → ファイル名で素早く移動
2. Ctrl+T → シンボル（関数名）で検索
3. F12 → 定義に移動
4. Shift+F12 → 参照箇所を確認
5. Alt+← → 元の場所に戻る

コードを書く時

1. Ctrl+Space → 補完候補を表示
2. Ctrl+/ → コメントアウト
3. Alt+↑/↓ → 行の並び替え
4. Shift+Alt+↓ → 行の複製
5. Shift+Alt+F → コードフォーマット

リファクタリングする時

1. F2 → シンボル名変更（全箇所一括リネーム）
2. Ctrl+D → 同じ単語を順に選択
3. Ctrl+Shift+L → 全箇所を一括選択
4. Ctrl+. → クイックフィックス（AIによる修正案）
5. Ctrl+H → 文字列置換

デバッグする時

1. F9 → ブレークポイント設定
2. F5 → デバッグ開始
3. F10 → ステップ実行（関数をスキップ）
4. F11 → 関数内に入る
5. Shift+F11 → 関数から抜ける
6. Shift+F5 → デバッグ終了

チームでレビューする時

1. Ctrl+Shift+G → Gitの差分確認
2. Alt+F3 / Shift+Alt+F3 → 変更箇所を順に確認
3. F8 / Shift+F8 → エラー箇所を順に確認
4. Ctrl+K Ctrl+Z → Zen Modeで集中してレビュー

まとめ

VSCodeのプルダウンメニューには、知られていない便利な機能が数多く含まれています。

覚え方のコツ：

1. まずは Ctrl+Shift+P（コマンドパレット）を覚える
2. 日常的に使う操作から少しずつショートカットに置き換える
3. 困ったら Ctrl+Shift+P で機能を検索して、そのショートカットを確認する
4. メニューを開いた時に右側に表示されるショートカットを意識して見る習慣をつける

おすすめの学習順：

Week 1: ファイル操作（Ctrl+P, Ctrl+S, Ctrl+O）
Week 2: 編集操作（Ctrl+F, Ctrl+H, Ctrl+/, Alt+↑/↓）
Week 3: マルチカーソル（Ctrl+D, Ctrl+Alt+↑/↓）
Week 4: ナビゲーション（F12, Alt+←, F8）
Week 5: デバッグ（F5, F9, F10, F11）

メニューを一つひとつ確認しながら、日々の開発に活かしてください。

関連記事

VSCodeのキーボードショートカット全般については姉妹記事もご覧ください：

VSCode標準ショートカットキー完全ガイド【日本語解説・おすすめ付き】

はじめにVSCodeを使いこなすには、ショートカットキーの習得が必須です。しかし、VSCodeの標準ショートカット一覧は英語表記で分かりにくいのが難点。本記事では、VSCodeの標準ショートカットキーをカテゴリ別に日本語化し、特に重要なもの...

caymezon.com

2026.01.25

Eclipseをお使いの方はこちら：

Eclipse標準ショートカットキー完全ガイド【日本語解説・おすすめ付き】

はじめにEclipseを使いこなすには、ショートカットキーの習得が必須です。特にJava開発では、リファクタリングやコード補完、デバッグなど、ショートカットキーを活用することで作業効率が劇的に向上します。本記事では、Eclipse（STS4...

caymezon.com

2026.02.06

タグ: #VSCode #ショートカットキー #メニュー #生産性向上 #効率化 #エディター

The post VSCode全プルダウンメニュー完全解説【ショートカットキー付き・使いどころ徹底ガイド】 first appeared on CayTech Lab.

はじめに：読みづらいSQLに苦労していませんか?

開発やデータ分析の現場で、こんな経験はありませんか？

SELECT u.id,u.name,u.email,o.order_id,o.total FROM users u INNER JOIN orders o ON u.id=o.user_id WHERE u.status='active' AND o.created_at>='2026-01-01' ORDER BY o.created_at DESC;

改行もインデントもない1行のSQLクエリ。ログから抽出したSQL、他人が書いた圧縮されたクエリ、古いシステムから取り出したクエリ…。

こういったSQLを読み解く時、手作業で整形するのは本当に面倒です：

1. 手動でキーワードごとに改行
2. インデントを調整
3. カンマの位置を揃える
4. 大文字・小文字を統一

エディタで1つずつ編集するのは時間の無駄です。

もし、VSCodeで選択したSQLを1キー操作で整形し、新規ファイルに出力できたら便利だと思いませんか？

さらに、複数のSQL方言（MySQL、PostgreSQL、Oracle等）に対応し、キーワードの大文字/小文字やインデント幅を選択できたら？

今回、sql-formatterライブラリを活用したSQL整形ツールをVSCodeのTypeScriptマクロとして実装しました。

同じようにVSCodeで少しでも効率化したい開発者の方に、ぜひ参考にしていただきたい内容です。

Amazon検索[本 TypeScript]

この記事で分かること

• SQL整形ツールの機能と使い方
• sql-formatterライブラリの活用方法
• 対応するSQL方言（8種類）
• オプション選択（キーワードケース、インデント幅）
• TypeScript実装の詳細コード
• エラーハンドリングとユーザビリティ
• 実務での活用例

なぜSQL整形ツールが必要なのか？

開発現場でのSQL整形の課題

課題1：ログから抽出したSQLが読めない

SELECT*FROM users WHERE status='active'AND created_at>='2026-01-01'ORDER BY id DESC LIMIT 10;

→ 本番環境のログから取り出したクエリは、改行もインデントもなく圧縮されている

課題2：SQL方言の違いに対応できない

• MySQL独自の構文（LIMIT、バッククォート）
• PostgreSQL独自の構文（::型キャスト、RETURNING）
• Oracle独自の構文（DUAL、ROWNUM、PL/SQL）
• SQL Server独自の構文（TOP、[]識別子）

→ 汎用的な整形ツールでは方言の違いを正しく扱えない

課題3：コーディング規約の統一

• プロジェクトA：キーワードは大文字（SELECT、FROM）
• プロジェクトB：キーワードは小文字（select、from）
• プロジェクトC：インデントは2スペース
• プロジェクトD：インデントは4スペース

→ 手作業での統一は非効率

既存のSQL整形ツールの問題点

オンライン整形ツール：

• ブラウザで別サイトを開く手間
• セキュリティの懸念（機密SQLを外部に送信）
• ネットワーク接続が必要

DBクライアントツール：

• 特定のDBにしか対応していない
• エディタ上で完結しない
• ツールの立ち上げに時間がかかる

VSCode拡張機能：

• 設定が複雑
• カスタマイズ性が低い
• 出力先が固定

このマクロで実現できること

実装した機能の概要

できること

選択されたSQLを整形して新規ファイルに出力

ステップ1：整形したいSQLを選択（または何も選択せずファイル全体）
ステップ2：コマンド実行
ステップ3：オプション選択ダイアログ
  - SQL方言（MySQL、PostgreSQL、Oracle等）
  - キーワードの大文字/小文字
  - インデント幅（2スペース、4スペース、タブ）
ステップ4：整形されたSQLが右側に新規ファイルで表示
ステップ5：保存ダイアログでファイル名を指定して保存

対応SQL方言（8種類）

1. Standard SQL（標準SQL）

-- デフォルト、最も汎用的
SELECT * FROM users WHERE id = 1;

2. MySQL / MariaDB

-- バッククォート、LIMIT構文
SELECT `id`, `name` FROM `users` LIMIT 10;

3. PostgreSQL

-- 型キャスト、RETURNING構文
SELECT id::INTEGER, name FROM users RETURNING *;

4. T-SQL (Microsoft SQL Server)

-- TOP構文、[]識別子
SELECT TOP 10 [id], [name] FROM [users];

5. PL/SQL (Oracle Database)

-- DUAL、ROWNUM、PL/SQLブロック
SELECT * FROM dual;
SELECT * FROM users WHERE ROWNUM <= 10;

6. Amazon Redshift

-- Redshift固有の構文
SELECT * FROM users LIMIT 10;

7. IBM DB2

-- DB2固有の構文
SELECT * FROM users FETCH FIRST 10 ROWS ONLY;

8. MariaDB

-- MariaDB固有の構文（MySQLベース）
SELECT * FROM users LIMIT 10;

オプション選択機能

1. SQL方言の選択

┌─────────────────────────────────────┐
│ SQL方言を選択してください           │
├─────────────────────────────────────┤
│ ○ Standard SQL (標準SQL)            │
│ ○ MySQL / MariaDB                   │
│ ○ PostgreSQL                        │
│ ○ T-SQL (SQL Server)                │
│ ○ PL/SQL (Oracle)                   │
│ ○ Amazon Redshift                   │
│ ○ IBM DB2                           │
└─────────────────────────────────────┘

2. キーワードの大文字/小文字

┌─────────────────────────────────────┐
│ キーワードの大文字/小文字を選択     │
├─────────────────────────────────────┤
│ ○ 大文字 (SELECT, FROM, WHERE)      │
│ ○ 小文字 (select, from, where)      │
│ ○ 元のまま保持                      │
└─────────────────────────────────────┘

3. インデント幅

┌─────────────────────────────────────┐
│ インデント幅を選択                  │
├─────────────────────────────────────┤
│ ○ 2スペース (推奨)                  │
│ ○ 4スペース                         │
│ ○ タブ                              │
└─────────────────────────────────────┘

整形例

整形前：

SELECT u.id,u.name,u.email,o.order_id,o.total,o.created_at FROM users u INNER JOIN orders o ON u.id=o.user_id WHERE u.status='active' AND o.total>=1000 AND o.created_at>='2026-01-01' ORDER BY o.created_at DESC,o.total DESC LIMIT 100;

整形後（大文字・2スペース）：

SELECT
  u.id,
  u.name,
  u.email,
  o.order_id,
  o.total,
  o.created_at
FROM
  users u
  INNER JOIN orders o ON u.id = o.user_id
WHERE
  u.status = 'active'
  AND o.total >= 1000
  AND o.created_at >= '2026-01-01'
ORDER BY
  o.created_at DESC,
  o.total DESC
LIMIT
  100;

整形後（小文字・4スペース）：

select
    u.id,
    u.name,
    u.email,
    o.order_id,
    o.total,
    o.created_at
from
    users u
    inner join orders o on u.id = o.user_id
where
    u.status = 'active'
    and o.total >= 1000
    and o.created_at >= '2026-01-01'
order by
    o.created_at desc,
    o.total desc
limit
    100;

具体的な使用場面とメリット

場面1：本番環境のログからSQLを抽出して分析

シーン：パフォーマンス問題の調査

application.log
---
[2026-02-15 10:30:45] Slow Query: SELECT u.id,u.name,p.product_id,p.name,p.price FROM users u JOIN purchases pu ON u.id=pu.user_id JOIN products p ON pu.product_id=p.id WHERE u.created_at>='2026-01-01' ORDER BY pu.created_at DESC;

手順：

1. SQLの部分を選択
2. コマンド実行
3. 方言選択（MySQL）
4. 大文字・2スペース
5. 整形されたSQLを確認してインデックス追加の検討

メリット：

• 圧縮されたログからSQLを即座に読みやすく変換
• 結合条件やWHERE句を視覚的に確認
• パフォーマンスチューニングの第一歩

場面2：他人が書いた複雑なクエリをレビュー

シーン：コードレビュー

-- レビュー対象のSQL（圧縮されている）
select u.id,u.name,u.email,count(o.order_id) as order_count,sum(o.total) as total_sales from users u left join orders o on u.id=o.user_id where u.status='active' group by u.id,u.name,u.email having count(o.order_id)>0 order by total_sales desc;

手順：

1. SQLを選択
2. コマンド実行
3. 方言選択（Standard SQL）
4. 大文字・2スペース
5. 整形されたSQLでロジックを確認

メリット：

• GROUP BYとHAVINGの条件を明確化
• 結合条件の妥当性を視覚的に確認
• レビューコメントを的確に指摘

場面3：マイグレーションスクリプトの整形

シーン：データベース移行作業

-- 古いシステムから取り出したDDL（フォーマットが崩れている）
create table users(id int primary key,name varchar(100) not null,email varchar(255) unique not null,status varchar(20) default 'active',created_at timestamp default current_timestamp);

手順：

1. DDLを選択
2. コマンド実行
3. 方言選択（PostgreSQL）
4. 大文字・2スペース
5. 整形されたDDLを確認してマイグレーションファイルに記載

メリット：

• カラム定義を視覚的に確認
• NOT NULL、DEFAULT、UNIQUEの制約を明確化
• チームメンバーとの共有が容易

場面4：プロジェクトのコーディング規約統一

シーン：新メンバーが参加してコーディング規約がバラバラ

-- メンバーAの書き方（小文字・インデントなし）
select * from users where status='active';

-- メンバーBの書き方（大文字・4スペース）
SELECT
    *
FROM
    users
WHERE
    status = 'active';

手順：

1. すべてのSQLファイルを順次整形
2. 方言選択（MySQL）
3. 統一ルール：大文字・2スペース
4. プロジェクト全体のSQL規約を統一

メリット：

• コードレビューの負担軽減
• 可読性の向上
• 新メンバーのオンボーディングを円滑化

場面5：Oracle PL/SQLのスラッシュ区切りに対応

シーン：Oracle開発環境でのPL/SQLブロック

BEGIN
  INSERT INTO users (id, name) VALUES (1, 'Test');
  COMMIT;
END; /

問題：

• sql-formatterはデフォルトで / を行末にくっつけてしまう
• Oracle SQL*Plusでは / が独立した行にないとエラー

このマクロの対応：

• postProcessSlashSeparator() 関数で / を独立した行に移動
• Oracle開発者にとって使いやすい形式で出力

BEGIN
  INSERT INTO users (id, name) VALUES (1, 'Test');
  COMMIT;
END;
/

場面6：複数SQLの一括整形

シーン：複数のクエリが含まれるファイル

SELECT * FROM users WHERE id=1; SELECT * FROM orders WHERE user_id=1; SELECT * FROM products WHERE category='electronics';

手順：

1. ファイル全体を対象（何も選択しない状態でコマンド実行）
2. 方言選択（Standard SQL）
3. 大文字・2スペース
4. 整形された複数のSQLを確認

出力：

SELECT
  *
FROM
  users
WHERE
  id = 1;

SELECT
  *
FROM
  orders
WHERE
  user_id = 1;

SELECT
  *
FROM
  products
WHERE
  category = 'electronics';

メリット：

• クエリ間に2行の空行を自動挿入（linesBetweenQueries: 2）
• 複数クエリの視認性向上

TypeScript実装の詳細

実際のコードを紹介します。formatSql.tsファイルに実装しました。

import * as vscode from 'vscode';
import * as path from 'path';
import { format } from 'sql-formatter'; // sql-formatterライブラリをインポート

/**
 * SQL整形ツール（sql-formatterライブラリ使用）
 * 選択されたSQLを整形して新規ファイルに出力
 */
export async function formatSql() {
    const editor = vscode.window.activeTextEditor;
    if (!editor) {
        vscode.window.showWarningMessage('アクティブなエディタがありません');
        return;
    }

    const selection = editor.selection;
    const document = editor.document;

    // 選択範囲がある場合は選択範囲、なければファイル全体を対象
    let sqlText: string;
    if (!selection.isEmpty) {
        sqlText = document.getText(selection);
    } else {
        sqlText = document.getText();
    }

    if (!sqlText || sqlText.trim().length === 0) {
        vscode.window.showWarningMessage('整形対象のSQLがありません');
        return;
    }

    // オプション選択ダイアログを表示
    const options = await showFormatOptionsDialog();
    if (!options) {
        return; // ユーザーがキャンセルした場合
    }

    try {
        // SQL整形を実行
        const formattedSql = formatSqlText(sqlText, options);
        // 新規ファイルに出力
        await createResultFile(formattedSql);
        vscode.window.showInformationMessage('SQL整形が完了しました');
    } catch (error: any) {
        // パースエラーの場合は詳細なメッセージを表示
        if (error.message && error.message.includes('Parse error')) {
            const message =
                'SQL整形に失敗しました。\n\n' +
                '原因：SQLとして認識できない文字が含まれています。\n' +
                '（例：△、●、■などの記号、不正なSQL構文）\n\n' +
                '対処法：\n' +
                '1. SQL以外のテキストやコメントを削除してください\n' +
                '2. 特殊文字（△など）を削除してください\n' +
                '3. SQL構文が正しいか確認してください\n\n' +
                `エラー詳細: ${error.message}`;

            vscode.window.showErrorMessage(message, { modal: true });
        } else {
            vscode.window.showErrorMessage(`SQL整形エラー: ${error.message || error}`);
        }
        console.error('SQL formatting error:', error);
    }
}

/**
 * フォーマットオプション
 */
interface FormatOptions {
    language: 'sql' | 'mysql' | 'postgresql' | 'tsql' | 'plsql' | 'mariadb' | 'db2' | 'redshift';
    keywordCase: 'upper' | 'lower' | 'preserve';
    tabWidth: number;
    useTabs: boolean;
}

/**
 * フォーマットオプション選択ダイアログ
 */
async function showFormatOptionsDialog(): Promise {
    // 1. SQL方言の選択
    const dialectItems = [
        { label: 'Standard SQL', value: 'sql' as const, description: '標準SQL（デフォルト）' },
        { label: 'MySQL / MariaDB', value: 'mysql' as const, description: 'MySQL/MariaDB方言' },
        { label: 'PostgreSQL', value: 'postgresql' as const, description: 'PostgreSQL方言' },
        { label: 'T-SQL (SQL Server)', value: 'tsql' as const, description: 'Microsoft SQL Server' },
        { label: 'PL/SQL (Oracle)', value: 'plsql' as const, description: 'Oracle Database' },
        { label: 'Amazon Redshift', value: 'redshift' as const, description: 'Amazon Redshift' },
        { label: 'IBM DB2', value: 'db2' as const, description: 'IBM DB2' }
    ];

    const selectedDialect = await vscode.window.showQuickPick(dialectItems, {
        placeHolder: 'SQL方言を選択してください',
        ignoreFocusOut: true // ダイアログ外クリックでキャンセルされないようにする
    });

    if (!selectedDialect) {
        return null; // キャンセル
    }

    // 2. キーワードの大文字/小文字
    const caseItems = [
        { label: '大文字 (SELECT, FROM, WHERE)', value: 'upper' as const, description: 'キーワードを大文字に' },
        { label: '小文字 (select, from, where)', value: 'lower' as const, description: 'キーワードを小文字に' },
        { label: '元のまま保持', value: 'preserve' as const, description: '元の大文字/小文字を保持' }
    ];

    const selectedCase = await vscode.window.showQuickPick(caseItems, {
        placeHolder: 'キーワードの大文字/小文字を選択してください',
        ignoreFocusOut: true
    });

    if (!selectedCase) {
        return null; // キャンセル
    }

    // 3. インデント幅
    const indentItems = [
        { label: '2スペース', tabWidth: 2, useTabs: false, description: '推奨' },
        { label: '4スペース', tabWidth: 4, useTabs: false },
        { label: 'タブ', tabWidth: 4, useTabs: true }
    ];

    const selectedIndent = await vscode.window.showQuickPick(indentItems, {
        placeHolder: 'インデント幅を選択してください',
        ignoreFocusOut: true
    });

    if (!selectedIndent) {
        return null; // キャンセル
    }

    return {
        language: selectedDialect.value,
        keywordCase: selectedCase.value,
        tabWidth: selectedIndent.tabWidth,
        useTabs: selectedIndent.useTabs
    };
}

/**
 * SQLテキストを整形
 */
function formatSqlText(sql: string, options: FormatOptions): string {
    const formattedSql = format(sql, {
        language: options.language, // SQL方言を指定
        keywordCase: options.keywordCase, // キーワードの大文字/小文字
        tabWidth: options.tabWidth, // インデント幅
        useTabs: options.useTabs, // タブ使用有無
        linesBetweenQueries: 2 // クエリ間の空行数（複数SQLの場合）
    });

    // Oracle PL/SQL の / を独立した行にする後処理
    // 例: "dual /" → "dual\n/"
    return postProcessSlashSeparator(formattedSql);
}

/**
 * Oracle PL/SQL のスラッシュ区切りを独立した行にする後処理
 */
function postProcessSlashSeparator(sql: string): string {
    // 行末のスラッシュの前に改行を挿入
    // パターン: 任意の文字列 + スペース + / + 改行 → 文字列 + 改行 + / + 改行
    return sql.replace(/\s+\/\s*$/gm, '\n/');
}

/**
 * 結果を新規ファイルに出力
 */
async function createResultFile(formattedSql: string): Promise {
    // 新規ドキュメントを作成（言語モードをSQLに設定）
    const doc = await vscode.workspace.openTextDocument({
        content: formattedSql,
        language: 'sql'
    });

    // 右側に並べて表示
    await vscode.window.showTextDocument(doc, {
        viewColumn: vscode.ViewColumn.Beside,
        preview: false
    });

    // ファイル名を自動生成
    const suggestedName = generateFileName(new Date());

    // 保存ダイアログを表示
    const uri = await vscode.window.showSaveDialog({
        defaultUri: vscode.Uri.file(suggestedName),
        filters: {
            'SQL files': ['sql'],
            'Text files': ['txt'],
            'All files': ['*']
        }
    });

    if (uri) {
        // ファイルを作成
        const edit = new vscode.WorkspaceEdit();
        edit.createFile(uri, { overwrite: true });
        await vscode.workspace.applyEdit(edit);

        // 内容を書き込み
        await vscode.workspace.fs.writeFile(
            uri,
            Buffer.from(formattedSql, 'utf8')
        );

        vscode.window.showInformationMessage(
            `整形済みSQLを保存しました: ${path.basename(uri.fsPath)}`
        );
    }
}

/**
 * 出力ファイル名を生成
 */
function generateFileName(date: Date): string {
    const timestamp = formatDateTimeForFile(date);
    return `formatted_sql_${timestamp}.sql`;
}

/**
 * 日時フォーマット（ファイル名用）
 */
function formatDateTimeForFile(date: Date): string {
    const year = date.getFullYear();
    const month = String(date.getMonth() + 1).padStart(2, '0');
    const day = String(date.getDate()).padStart(2, '0');
    const hours = String(date.getHours()).padStart(2, '0');
    const minutes = String(date.getMinutes()).padStart(2, '0');
    const seconds = String(date.getSeconds()).padStart(2, '0');

    return `${year}${month}${day}_${hours}${minutes}${seconds}`;
}

コードのポイント解説

1. sql-formatterライブラリの活用

import { format } from 'sql-formatter'; // npmパッケージをインポート

const formattedSql = format(sql, {
    language: 'mysql', // SQL方言を指定
    keywordCase: 'upper', // キーワードを大文字に
    tabWidth: 2, // インデント幅
    useTabs: false, // スペースを使用
    linesBetweenQueries: 2 // 複数クエリ間の空行数
});

ポイント：

• sql-formatterは複数のSQL方言に対応した軽量ライブラリ
• オプションで細かくカスタマイズ可能
• パースエラー時には詳細なエラーメッセージを返す

2. オプション選択ダイアログの3段階構成

// 1. SQL方言を選択
const selectedDialect = await vscode.window.showQuickPick(dialectItems, {
    placeHolder: 'SQL方言を選択してください',
    ignoreFocusOut: true // ダイアログ外クリックでキャンセルされない
});

// 2. キーワードケースを選択
const selectedCase = await vscode.window.showQuickPick(caseItems, {
    placeHolder: 'キーワードの大文字/小文字を選択してください',
    ignoreFocusOut: true
});

// 3. インデント幅を選択
const selectedIndent = await vscode.window.showQuickPick(indentItems, {
    placeHolder: 'インデント幅を選択してください',
    ignoreFocusOut: true
});

ポイント：

• ignoreFocusOut: true でダイアログ外クリックでもキャンセルされない
• 3段階に分けることでユーザーの選択を明確化
• 各ステップでnullチェックして早期リターン

3. Oracle PL/SQLのスラッシュ区切り対応

/**
 * Oracle PL/SQL のスラッシュ区切りを独立した行にする後処理
 */
function postProcessSlashSeparator(sql: string): string {
    // 行末のスラッシュの前に改行を挿入
    // パターン: 任意の文字列 + スペース + / + 改行 → 文字列 + 改行 + / + 改行
    return sql.replace(/\s+\/\s*$/gm, '\n/');
}

ポイント：

• 正規表現 /\s+\/\s*$/gm で行末の / を検出
• gm フラグで複数行にわたって処理
• Oracle開発者にとって必須の後処理

4. エラーハンドリングの充実

try {
    const formattedSql = formatSqlText(sqlText, options);
    await createResultFile(formattedSql);
    vscode.window.showInformationMessage('SQL整形が完了しました');
} catch (error: any) {
    // パースエラーの場合は詳細なメッセージを表示
    if (error.message && error.message.includes('Parse error')) {
        const message =
            'SQL整形に失敗しました。\n\n' +
            '原因：SQLとして認識できない文字が含まれています。\n' +
            '（例：△、●、■などの記号、不正なSQL構文）\n\n' +
            '対処法：\n' +
            '1. SQL以外のテキストやコメントを削除してください\n' +
            '2. 特殊文字（△など）を削除してください\n' +
            '3. SQL構文が正しいか確認してください\n\n' +
            `エラー詳細: ${error.message}`;

        vscode.window.showErrorMessage(message, { modal: true });
    } else {
        vscode.window.showErrorMessage(`SQL整形エラー: ${error.message || error}`);
    }
    console.error('SQL formatting error:', error);
}

ポイント：

• Parse error を検出して専用のエラーメッセージを表示
• ユーザーに原因と対処法を明示
• modal: true でエラーダイアログを強調表示

5. 新規ファイル出力とファイル名自動生成

/**
 * 出力ファイル名を生成
 */
function generateFileName(date: Date): string {
    const timestamp = formatDateTimeForFile(date);
    return `formatted_sql_${timestamp}.sql`; // formatted_sql_20260215_103045.sql
}

/**
 * 日時フォーマット（ファイル名用）
 */
function formatDateTimeForFile(date: Date): string {
    const year = date.getFullYear();
    const month = String(date.getMonth() + 1).padStart(2, '0');
    const day = String(date.getDate()).padStart(2, '0');
    const hours = String(date.getHours()).padStart(2, '0');
    const minutes = String(date.getMinutes()).padStart(2, '0');
    const seconds = String(date.getSeconds()).padStart(2, '0');

    return `${year}${month}${day}_${hours}${minutes}${seconds}`; // 20260215_103045
}

ポイント：

• タイムスタンプ付きファイル名で重複を防止
• 年月日_時分秒の形式で整理しやすい
• 保存ダイアログで自動的にファイル名が提案される

6. 右側に並べて表示

// 右側に並べて表示
await vscode.window.showTextDocument(doc, {
    viewColumn: vscode.ViewColumn.Beside, // 右側に表示
    preview: false // プレビューモードを無効化
});

ポイント：

• vscode.ViewColumn.Beside で元のファイルと並べて表示
• 元のSQLと整形後のSQLを同時に確認可能
• preview: false で確実にエディタとして開く

使い方

1. 拡張機能のインストール

git clone https://github.com/xxxxx-sys/my-macros.git
cd my-macros

# 依存関係インストール
npm install --legacy-peer-deps

# sql-formatterライブラリをインストール
npm install sql-formatter

# パッケージ化
npm run compile
npx vsce package

# インストール
code --install-extension my-macros-0.0.7.vsix

2. 基本的な使い方

作業メモ.txt
---
SELECT u.id,u.name,o.order_id FROM users u JOIN orders o ON u.id=o.user_id WHERE u.status='active';

手順：

1. 整形したいSQLを選択（または何も選択せずファイル全体を対象）
2. コマンドパレットを開く（Ctrl+Shift+P）
3. "Format SQL" と入力して実行
4. オプションダイアログで選択：
   • SQL方言：MySQL
   • キーワード：大文字
   • インデント：2スペース
5. 整形されたSQLが右側に表示される
6. 保存ダイアログで保存

3. 実践例

シーン1: ログから抽出したSQLを整形

application.log
---
[2026-02-15 10:30:45] Slow Query: SELECT * FROM users WHERE status='active' AND created_at>='2026-01-01';

手順：

1. SQL部分を選択
2. コマンド実行
3. 方言選択（MySQL）
4. 整形されたSQLを確認

シーン2: 複数のクエリを一括整形

SELECT * FROM users; SELECT * FROM orders; SELECT * FROM products;

手順：

1. 何も選択せずコマンド実行
2. 方言選択（Standard SQL）
3. 整形された3つのSQLが空行区切りで出力

package.jsonの設定

{
  "contributes": {
    "commands": [
      {
        "command": "myMacros.formatSql",
        "title": "Format SQL",
        "category": "My Macros"
      }
    ],
    "keybindings": [
      {
        "command": "myMacros.formatSql",
        "key": "ctrl+shift+f",
        "when": "editorTextFocus"
      }
    ]
  },
  "dependencies": {
    "sql-formatter": "^15.0.0"
  }
}

extension.tsでの登録

import { formatSql } from './macros/formatSql';

export function activate(context: vscode.ExtensionContext) {
    const commands = [
        vscode.commands.registerCommand(
            'myMacros.formatSql',
            formatSql
        ),
        // ... 他のコマンド
    ];

    commands.forEach(command => context.subscriptions.push(command));
}

メリット・デメリット

メリット

✅ 圧倒的な効率化

• 1キー操作でSQL整形が完了
• オンラインツールやDBクライアントの立ち上げ不要
• VSCode上で完結

✅ 複数のSQL方言に対応

• MySQL、PostgreSQL、Oracle、SQL Server等に対応
• プロジェクトごとに適切な方言を選択可能

✅ 柔軟なカスタマイズ

• キーワードの大文字/小文字を選択
• インデント幅を選択（2スペース、4スペース、タブ）
• プロジェクトのコーディング規約に合わせて調整可能

✅ 安全性

• ローカル環境で完結（セキュリティ面で安心）
• 元のファイルは変更せず新規ファイルに出力
• エラー時の詳細メッセージで原因を把握

✅ 実務に即した機能

• Oracle PL/SQLのスラッシュ区切りに対応
• 複数クエリ間に空行を自動挿入
• タイムスタンプ付きファイル名で管理しやすい

デメリット

❌ sql-formatterの制限

• 完全に正しいSQL構文でないと整形できない
• 特殊な記号（△、●など）が含まれるとパースエラー
• 方言固有の構文で未対応のものもある

❌ 巨大なSQLファイルはパフォーマンス低下

• 数万行のSQLファイルは処理に時間がかかる可能性
• メモリ使用量が増加する場合あり

❌ 出力先が新規ファイル固定

• 元のファイルを直接置き換える機能はない
• 必ず新規ファイルに出力される

トラブルシューティング

Q: SQL整形に失敗する

A: SQLとして認識できない文字が含まれている

NG: SELECT * FROM users; -- △注意点
OK: SELECT * FROM users; -- 注意点

解決策：

• SQL以外のテキストや特殊文字を削除
• コメント内の記号を確認

Q: 方言を間違えて選択した

A: 再度実行して正しい方言を選択

誤: Standard SQLで整形したがMySQLのバッククォートが消えた
正: MySQLで整形してバッククォートを保持

解決策：

• MySQLの場合は "MySQL / MariaDB" を選択
• PostgreSQLの場合は "PostgreSQL" を選択

Q: 整形後のファイルを保存したくない

A: 保存ダイアログでキャンセル

解決策：

• 整形結果を確認したら保存ダイアログでキャンセル
• 一時的に確認するだけならそのままタブを閉じる

Q: オプション選択が面倒

A: デフォルト設定を変更したい場合はコードを修正

// デフォルト設定を変更する例
const options = {
    language: 'mysql', // 常にMySQLに固定
    keywordCase: 'upper', // 常に大文字に固定
    tabWidth: 2,
    useTabs: false
};

解決策：

• よく使う設定をデフォルトにしたい場合はコードを修正

まとめ：SQL整形を1キー操作で実現する快適さ

VSCodeでsql-formatterライブラリを活用したSQL整形ツールを実装しました。

このマクロの強み：

• 1キー操作でSQL整形が完了
• 複数のSQL方言に対応（MySQL、PostgreSQL、Oracle等）
• キーワードケースとインデント幅を選択可能
• ローカル環境で完結（セキュリティ面で安心）
• Oracle PL/SQLのスラッシュ区切りに対応
• 充実したエラーハンドリング

こんな人におすすめ：

• ログから抽出したSQLを頻繁に分析する
• 複数のDBを扱うプロジェクトに参加している
• コーディング規約の統一を効率化したい
• マウス操作を減らしたい
• VSCodeで開発環境を完結させたい

特に、本番環境のログから圧縮されたSQLを抽出して分析する場面では、このマクロが大きな威力を発揮します。

手作業で1つずつ改行とインデントを調整していた作業が、たった1回のキー操作で完了します。

「読みづらいSQLに苦労している」という方は、ぜひVSCodeでのSQL整形にお役立てください！

Amazon検索[本 TypeScript]

関連記事

• VSCodeで正規表現マッチを一括抽出するTypeScriptマクロ

VSCodeで「正規表現マッチ抽出」を実現するTypeScriptマクロ【ログ解析が10倍速くなる】

はじめにサーバーログやアプリケーションログを解析する時、こんな悩みありませんか？2024-02-08 10:00:00 INFO: Server started2024-02-08 10:01:00 ERROR: Connection fa...

caymezon.com

2026.02.08

• VSCodeで「選択行による一括置換」を実現するTypeScriptマクロ

VSCodeで「選択行による一括置換」を実現するTypeScriptマクロ【テキスト編集が10倍速くなる】

はじめにテキスト編集で「複数の文字列を一度に置換したい」と思ったことはありませんか？例えば、こんなシーン：変数名を複数箇所で一括変更テーブル定義のデータ型を複数列で一括更新ドキュメント内の用語統一を複数ワードで一括実施VSCodeの標準機能...

caymezon.com

2026.02.08

• VSCodeで「任意行までの一括選択・コピー」を実現するTypeScriptマクロ

VSCodeで「任意行までの一括選択・コピー」を実現するTypeScriptマクロ開発【サクラエディタ移行の集大成】

はじめに：テキスト編集における「範囲選択の不便さ」VSCodeで長いログファイルやドキュメントを編集していて、「この行から特定の文字列まで一気にコピーしたい」と思ったことはありませんか？通常のVSCodeでは、以下のような手順が必要です：開...

caymezon.com

2026.02.08

• VSCode TypeScriptマクロ開発ガイド【サクラエディタから移行した開発環境構築】

VSCode TypeScriptマクロ開発環境の完全ガイド【セットアップから運用まで】

はじめにVSCodeでカスタムマクロを作成したいけど、どうやって開発環境を構築すればいいか分からない。そんな悩みを持つ方に向けて、TypeScriptでVSCode拡張機能を開発する環境の構築から、実際にマクロを作成して使えるようにするまで...

caymezon.com

2026.01.25

タグ: #VSCode #TypeScript #マクロ #SQL #データベース #生産性向上 #sql-formatter

The post VSCodeで「SQL整形ツール」を実現するTypeScriptマクロ【sql-formatter活用で複数方言対応】 first appeared on CayTech Lab.

はじめに

「Markdownで記事を書くとき、画像挿入がいちいち面倒…」

ブログ執筆やドキュメント作成で、こんな経験をしたことがある人は多いはずです。

従来の作業フロー：

1. スクリーンショットを撮る
2. 画像編集ソフトで開く
3. ファイル名をつけて保存
4. imagesフォルダに移動
5. Markdownに![]形式で記述
→ 約5ステップ・30秒

このマクロを使えば、ショートカットキー一発で全て自動化できます！

本記事では、実際にClaude Codeを使って開発したマクロの詳細と、効果的な使い方を紹介します。

この記事で分かること

• クリップボード画像挿入マクロの機能
• コードの詳細解説
• インストール方法
• 実践的な使い方
• トラブルシューティング
• Claude Codeでの開発体験

こんな人におすすめ

• Markdownでブログやドキュメントを書く人
• 画像挿入作業を効率化したい人
• VSCodeでマクロを作りたい人
• TypeScriptで拡張機能開発を学びたい人

機能概要

できること

ショートカットキー一発で：

1. クリップボードの画像を取得
2. 画像名とファイル名を入力（ダイアログ）
3. ![]形式でカーソル位置に挿入
4. imagesフォルダに画像を保存
→ わずか10秒！

具体例

操作：

1. スクリーンショットを撮る（Win+Shift+S）
2. Ctrl+Shift+I を押す
3. 画像名入力: "サンプル画面"
4. ファイル名入力: "sample-screen"

結果：

✅ imagesフォルダが自動作成
✅ sample-screen.jpgが保存される
✅ Markdownテキストが挿入される

コード詳細解説

全体構造

// src/macros/insertImageFromClipboard.ts
import * as vscode from 'vscode';
import * as fs from 'fs';
import * as path from 'path';
import { exec } from 'child_process';
import { promisify } from 'util';

const execAsync = promisify(exec);

export async function insertImageFromClipboard() {
    // 機能実装
}

1. アクティブエディタの取得

const editor = vscode.window.activeTextEditor;
if (!editor) {
    vscode.window.showWarningMessage('アクティブなエディタがありません');
    return;
}

ポイント：

• VSCodeのアクティブなエディタを取得
• エディタがない場合は警告を表示

2. ユーザー入力の取得

// 画像名（altテキスト）
const imageName = await vscode.window.showInputBox({
    prompt: '画像名（altテキスト）を入力してください',
    placeHolder: '例: サンプル画像'
});

if (!imageName) return;

// ファイル名
const fileName = await vscode.window.showInputBox({
    prompt: 'ファイル名（拡張子なし）を入力してください',
    placeHolder: '例: sample-image'
});

if (!fileName) return;

ポイント：

• showInputBoxでユーザー入力を受け付け
• promptで説明文、placeHolderで例を表示
• キャンセルされたら処理中断

3. パス解決とフォルダ作成

// 現在のファイルがあるディレクトリ
const currentDir = path.dirname(editor.document.uri.fsPath);
const imagesDir = path.join(currentDir, 'images');

// imagesフォルダ作成（なければ）
if (!fs.existsSync(imagesDir)) {
    fs.mkdirSync(imagesDir, { recursive: true });
}

// 出力パス
const outputPath = path.join(imagesDir, `${fileName}.jpg`);

ポイント：

• path.dirnameで現在のディレクトリを取得
• fs.mkdirSyncでフォルダ作成
• recursive: trueで親フォルダも自動作成

4. PowerShellで画像取得

const psScript = `
    Add-Type -AssemblyName System.Windows.Forms;
    Add-Type -AssemblyName System.Drawing;
    $img = [System.Windows.Forms.Clipboard]::GetImage();
    if ($img) {
        $img.Save('${outputPath.replace(/\\/g, '\\\\')}', [System.Drawing.Imaging.ImageFormat]::Jpeg);
        exit 0;
    } else {
        exit 1;
    }
`;

try {
    await execAsync(`powershell -Command "${psScript}"`);
} catch (error) {
    vscode.window.showErrorMessage(`画像の取得に失敗しました`);
    return;
}

ポイント：

• Windows.Formsでクリップボードにアクセス
• JPEG形式で保存
• バックスラッシュをエスケープ

5. Markdownテキスト挿入

const markdownText = `![${imageName}](images/${fileName}.jpg)`;

editor.edit(editBuilder => {
    editBuilder.insert(editor.selection.active, markdownText);
});

vscode.window.showInformationMessage(
    `画像を挿入しました: ${fileName}.jpg`
);

ポイント：

• editor.editでテキスト編集
• カーソル位置に挿入
• 完了メッセージ表示

インストール方法

1. 拡張機能プロジェクトの準備

# プロジェクト作成
mkdir my-macros
cd my-macros

# 初期化
npm init -y

# VSCode拡張機能用パッケージ
npm install --save-dev @types/vscode @types/node typescript
npm install --save-dev @vscode/vsce

2. ファイル配置

my-macros/
├── src/
│   ├── extension.ts
│   └── macros/
│       └── insertImageFromClipboard.ts
├── package.json
└── tsconfig.json

3. extension.tsにコマンド登録

// src/extension.ts
import * as vscode from 'vscode';
import { insertImageFromClipboard } from './macros/insertImageFromClipboard';

export function activate(context: vscode.ExtensionContext) {
    const command = vscode.commands.registerCommand(
        'myMacros.insertImageFromClipboard',
        insertImageFromClipboard
    );
    
    context.subscriptions.push(command);
}

4. package.json設定

{
  "name": "my-macros",
  "contributes": {
    "commands": [
      {
        "command": "myMacros.insertImageFromClipboard",
        "title": "Insert Image from Clipboard"
      }
    ],
    "keybindings": [
      {
        "command": "myMacros.insertImageFromClipboard",
        "key": "ctrl+shift+i",
        "when": "editorTextFocus"
      }
    ]
  }
}

5. ビルドとインストール

# コンパイル
npm run compile

# VSIXパッケージ作成
vsce package

# VSCodeにインストール
code --install-extension my-macros-0.0.1.vsix

実践的な使い方

基本的な使い方

1. スクリーンショットを撮る

Windows: Win + Shift + S
macOS: Cmd + Shift + 4

2. Markdownファイルを開く

code article.md

3. 挿入位置にカーソルを置く

4. Ctrl+Shift+I を押す

5. 情報を入力

画像名: サンプル画面
ファイル名: sample-screen

ブログ執筆での活用

記事構造：

article/
├── post.md
└── images/
    ├── intro.jpg
    ├── step1.jpg
    ├── step2.jpg
    └── result.jpg

執筆フロー：

# 記事タイトル

## はじめに


↑ Ctrl+Shift+Iで一発挿入！

## 手順

### ステップ1


↑ スクリーンショット後すぐ挿入！

### ステップ2

ドキュメント作成での活用

設計書：

# システム設計書

## 画面遷移図



## データベース設計



## UIモックアップ

議事録での活用

# 2026/02/12 打ち合わせ議事録

## ホワイトボード



## 資料スクリーンショット

トラブルシューティング

エラー: クリップボードに画像がない

エラーメッセージ：

画像の取得に失敗しました

原因：

• クリップボードに画像がコピーされていない
• テキストデータやファイルがコピーされている

解決策：

1. スクリーンショットを再度撮る
2. 画像編集ソフトからコピー
3. ブラウザの画像を右クリック→画像をコピー

エラー: imagesフォルダ作成に失敗

エラーメッセージ：

EACCES: permission denied

原因：

• 書き込み権限がない

解決策：

1. ファイルの保存場所を変更
2. ユーザーディレクトリで作業
3. VSCodeを管理者権限で起動

エラー: ショートカットキーが動かない

原因：

• 他の拡張機能とキーバインドが競合

確認方法：

1. Ctrl+Shift+P
2. "Preferences: Open Keyboard Shortcuts"
3. "ctrl+shift+i" で検索

解決策：

// keybindings.json
{
    "key": "ctrl+alt+i",  // 別のキーに変更
    "command": "myMacros.insertImageFromClipboard",
    "when": "editorTextFocus"
}

Claude Codeでの開発体験

このマクロは、実際にClaude Codeを使って開発しました。

開発時間の比較

Claude Codeを使った場合と使わなかった場合で、開発効率に大きな違いがありました。

詳しくはこちらの記事で解説しています：

Claude Code vs Web版・Desktop版 開発効率徹底比較｜実際のマクロ開発で検証

はじめに「Claude Codeって本当に効率的なの？」そんな疑問を持つ開発者は多いはずです。実際、Web版やDesktop版と比べて、どれくらいのメリットがあるのかイメージしにくいかもしれません。本記事では、実際に「VSCodeでクリップ...

caymezon.com

2026.02.14

主なポイント：

• Claude Code: 8分
• Web版: 17分
• 効率: 53%向上

Claude Codeのメリット

✅ プロジェクト理解

• 既存マクロのパターンを自動認識
• 一貫性のあるコード生成

✅ 直接ファイル操作

• コピペ不要
• エディタ切替不要

✅ 高速な修正

• エラーを即座に修正
• 全体の整合性保持

メリット・デメリット

メリット

✅ 圧倒的な時短効果

従来: 30秒 × 10画像 = 5分
マクロ: 10秒 × 10画像 = 1.5分
→ 3.5分の短縮！70%減）

✅ ファイル管理が楽

• 自動でimagesフォルダ作成
• ファイル名の統一管理

✅ ミスが減る

• ファイル名のタイプミス防止
• パス間違い防止

デメリット

⚠️ Windows専用

• PowerShell依存
• macOS/Linuxでは修正必要

⚠️ 初期設定が必要

• 拡張機能のインストール
• ショートカットキー設定

まとめ

VSCodeでクリップボード画像をMarkdown化するマクロを紹介しました。

主な機能：

✅ ショートカットキー一発で画像挿入
✅ ダイアログで画像名とファイル名を入力
✅ ![]形式で自動挿入
✅ imagesフォルダに画像保存

効果：

🚀 70%の時短
🚀 ミスの削減
🚀 ワークフローの改善

活用シーン：

📝 ブログ執筆
📝 技術ドキュメント
📝 議事録作成
📝 README作成

開発体験：

Claude Codeを使って、8分で実装できました。詳しくは関連記事をご覧ください。

関連記事：

• Claude Code完全ガイド

Claude Code完全ガイド｜ターミナルで動くAIコーディングアシスタントの全貌【2026年6月版】

はじめに「AIにコードを書かせたいけど、ブラウザとエディタを行き来するのが面倒…」そんな悩みを解決するのがClaude Codeです。2026年6月時点で、Anthropicが提供するターミナル型AIエージェントとして、開発者の間で急速に注...

caymezon.com

2026.02.14

• Claude Code環境構築ガイド

Claude Code環境構築完全ガイド｜初心者でも30分でセットアップできる詳細手順

はじめに「Claude Codeを使ってみたいけど、環境構築が難しそう…」そんな不安を持つ方も多いはずです。実際、ターミナルベースのツールは初心者にとってハードルが高く感じられます。しかし、この記事の手順通りに進めれば、初心者でも30分でC...

caymezon.com

2026.02.14

• Claude Code vs Web版・Desktop版 比較

Claude Code vs Web版・Desktop版 開発効率徹底比較｜実際のマクロ開発で検証

はじめに「Claude Codeって本当に効率的なの？」そんな疑問を持つ開発者は多いはずです。実際、Web版やDesktop版と比べて、どれくらいのメリットがあるのかイメージしにくいかもしれません。本記事では、実際に「VSCodeでクリップ...

caymezon.com

2026.02.14

タグ: #VSCode #TypeScript #マクロ #Markdown #生産性向上 #クリップボード

The post VSCodeで画像挿入が一瞬！クリップボード画像をMarkdown化するTypeScriptマクロ first appeared on CayTech Lab.

はじめに：引用符や括弧内のテキスト選択、面倒じゃないですか？

VSCodeで文字列編集をしていて、こんな経験はありませんか？

const message = "このテキストだけコピーしたい";
const path = '/home/user/documents/report.pdf';
const config = { name: "設定値", value: 123 };

ダブルクォーテーション内の文字列だけコピーしたいときに、以下のような操作が必要です：

1. マウスで開始位置をクリック
2. ドラッグして終了位置まで選択
3. Ctrl+Cでコピー

あるいは：

1. Ctrl+Shift+→を何度も押して単語単位で選択
2. 微調整のためにShift+→/←
3. Ctrl+Cでコピー

特に長い文字列や入れ子構造の場合、この作業は非常に煩雑です。

標準のVSCodeには「Ctrl+Shift+→」「Alt+Shift+→」などの単語単位選択機能がありますが、デリミタ（区切り文字）を意識した選択には対応していません。引用符や括弧の中身だけを1キー操作で選択・コピーできたら便利だと思いませんか？

そこで、カーソル位置から自動でデリミタを検索し、その間のテキストを1キーで選択・コピーするTypeScriptマクロを開発しました。

この記事で分かること

• デリミタ間テキスト選択コピーの機能と使い方
• 対応するデリミタの種類（18種類）
• コピーせず選択のみを行う Ctrl+Alt+S の活用法
• 選択方向による動作の違い（右方向/左方向）
• TypeScript実装の詳細コード
• 実務での活用例とパフォーマンス

実装した機能の概要

できること

2つのショートカットキーで使い分けられます：

• Ctrl+Alt+D : デリミタ間を選択してクリップボードにコピー
• Ctrl+Alt+S : デリミタ間を選択のみ（クリップボードは変更しない）

Ctrl+Alt+S は「コピー元でCtrl+Alt+D → 置換先でCtrl+Alt+S → Ctrl+V」というコピー&貼り付け置換の用途を想定しています。

Ctrl+Alt+D を押すだけで、カーソル位置の最も近いデリミタ間のテキストを自動選択・コピー

例：＜"「あいうえお」、【かきくけこ】、｛さしすせそ｝"＞
          ↑ここにカーソル
          
Ctrl+Alt+D を押す
          
→「あいうえお」だけが選択・コピーされる（引用符は除外）

対応デリミタ（18種類）

クォーテーション・スラッシュ系

• "～" (ダブルクォート)
• '～' (シングルクォート)
• `～` (バッククォート)
• /～/ (スラッシュ・半角)
• ／～／ (スラッシュ・全角)
• \～\ (バックスラッシュ・半角)
• ￥～￥ (円記号・全角)
• |～| (パイプ・半角)
• ｜～｜ (パイプ・全角)

括弧系（半角・全角）

• (～) / （～） (丸括弧)
• [～] (角括弧)
• {～} / ｛～｝ (波括弧)
• <～> / ＜～＞ (山括弧)
• 【～】 (墨付き括弧)
• 「～」 (鉤括弧)

3つの動作モード

1. 通常モード（カーソル位置から左に検索）

＜"「あいうえお」、【かきくけこ】"＞
       ↑カーソル
       
→ カーソルの左にある最も近い開始デリミタ「"」を検出
→ 対応する終了デリミタ「"」を右に検索
→ 「あいうえお」、【かきくけこ】 が選択される

2. 右方向モード（1文字選択 + カーソルが右側）

＜"「あいうえお」、【かきくけこ】"＞
   ↑選択    ↑カーソル（左→右に選択）
   
→ 選択文字「"」が開始デリミタか判定
→ 右に終了デリミタ「"」を検索
→ 「あいうえお」、【かきくけこ】 が選択される

3. 左方向モード（1文字選択 + カーソルが左側）

＜"「あいうえお」、【かきくけこ】"＞
   ↑カーソル ↑選択（右→左に選択）
   
→ 選択文字「"」が終了デリミタか判定
→ 左に開始デリミタ「"」を検索
→ 「あいうえお」、【かきくけこ】 が選択される

フォールバック機能

デリミタが見つからない場合は、行全体をコピー（Ctrl+Alt+D）または行全体を選択（Ctrl+Alt+S）します。

具体的な使用場面とメリット

場面1：コード内の文字列リテラルを抽出

const errorMessage = "接続に失敗しました。しばらく経ってから再度お試しください。";

文字列の中にカーソルを置いてCtrl+Alt+D → 文字列だけが即座にコピーされる。

従来の方法：

1. "の直後をクリック
2. Shift+Endで行末まで選択
3. Shift+←で"の手前まで調整
4. Ctrl+C

このマクロ：

1. 文字列内にカーソルを置く
2. Ctrl+Alt+D

たった1操作で完了！

場面2：ファイルパスを素早く抽出

const configPath = '/etc/nginx/sites-available/default';
const dataPath = '/var/www/html/data/uploads/2026/02/';

パス内にカーソルを置いてCtrl+Alt+D → パス全体がコピーされる。

場面3：JSONのキーや値を抽出

{
  "database": {
    "host": "localhost",
    "port": 5432,
    "name": "production_db"
  }
}

各値にカーソルを置いてCtrl+Alt+D → 値だけが抽出される。

場面4：正規表現パターンを抽出

const pattern = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;

パターン内にカーソルを置いてCtrl+Alt+D → 正規表現本体だけがコピーされる（/～/を除外）。

場面5：複雑な入れ子構造から特定部分を抽出

異なる種類のデリミタの入れ子

＜"「あいうえお」、【かきくけこ】、｛さしすせそ｝"＞

この複雑な構造でも：

• 「の後にカーソル → あいうえおが選択される
• 【の後にカーソル → かきくけこが選択される
• ＜の後にカーソル → 最外側の"～"が選択される

最も近いデリミタを自動判別するため、入れ子構造でも正確に動作します。

同じ種類のデリミタのネスト構造

function outer(a, inner(b, c), d)

この場合、カーソルがouterにあるとき：

• 左で最も近い(（outerの後）を検出
• ネストレベルを考慮して対応する)を検索
• 内側のinner(b, c)のネストをカウント
• a, inner(b, c), d全体が正確に選択される ✅

従来バージョンでは誤ってouter(a, inner(b, cが選択されていましたが、ネスト対応により正確に動作するようになりました。

場面6：Markdown内のコード抜き出し

インラインコードは`console.log('Hello')`のように書きます。

バッククォート内にカーソルを置いてCtrl+Alt+D → console.log('Hello')だけがコピーされる。

場面7：コピー&貼り付け置換（Ctrl+Alt+Sの活用）

Ctrl+Alt+S（選択のみ）との組み合わせで、貼り付けによる置換が手軽にできます。

const oldValue = "置換前の文字列";
const newValue = "置換後の文字列";

手順：

1. "置換前の文字列" 内にカーソル → Ctrl+Alt+D でコピー
2. "置換後の文字列" 内にカーソルを移動
3. Ctrl+Alt+S で置換対象を選択
4. Ctrl+V で貼り付け → 置換完了！

クリップボードを変更せずに置換先だけを選択できるので、途中でクリップボードが上書きされる心配がありません。

メリットまとめ

• マウス操作不要: カーソル位置だけで判定
• 高速: キーボード1回で完結
• 正確: デリミタを自動検出
• 柔軟: 選択方向で動作を変更可能、コピー/選択を使い分け可能
• 安全: デリミタが見つからなくても行全体をコピー/選択

改修履歴：ネスト構造への対応

改修前の問題点

初期バージョンでは、ネスト（入れ子）構造の括弧を正しく処理できない問題がありました。

問題の例：

function(b,c){...}

この場合、カーソルがfunctionにあるとき：

1. 左から最も近い開始デリミタ(を検出
2. その位置から右に最初に見つかった終了デリミタ)をマッチング
3. しかし、最初の)はb,c)の閉じ括弧なので、function(b,cが誤って選択される ❌

ネストレベルを考慮していないため、入れ子構造で誤動作していました。

改修内容：括弧のバランスを考慮したマッチング

VSCodeのCtrl+Shift+\（対応する括弧へジャンプ）と同じように、ネストレベルをカウントしながら対応する括弧を探すアルゴリズムを実装しました。

アルゴリズム：

1. カーソル位置から左に開始デリミタを検索
2. その位置から右に向かって：
   • 同じ開始デリミタが出現 → カウンタ +1（ネストが深くなる）
   • 対応する終了デリミタが出現 → カウンタ -1（ネストから抜ける）
   • カウンタが 0 になった位置が対応する終了デリミタ ✅

追加した関数：

• findMatchingEndDelimiter() - 順方向のネスト対応マッチング
• findMatchingStartDelimiter() - 逆方向のネスト対応マッチング

これにより、複雑な入れ子構造でも正確にデリミタのペアを検出できるようになりました。

TypeScript実装の詳細

実際のコードを紹介します。copyTextBetweenDelimiters.tsファイルに実装しました。

import * as vscode from 'vscode';

/**
 * デリミタペアの定義（開始文字と終了文字）
 */
const DELIMITER_PAIRS: Array<{ start: string; end: string }> = [
    { start: '"', end: '"' },
    { start: "'", end: "'" },
    { start: '`', end: '`' }, // バッククォート（テンプレートリテラル・Markdownインラインコード）
    { start: '/', end: '/' },
    { start: '／', end: '／' },
    { start: '\\', end: '\\' },
    { start: '￥', end: '￥' },
    { start: '|', end: '|' },
    { start: '｜', end: '｜' },
    { start: '「', end: '」' },
    { start: '[', end: ']' },
    { start: '【', end: '】' },
    { start: '{', end: '}' },
    { start: '｛', end: '｝' },
    { start: '(', end: ')' },
    { start: '（', end: '）' },
    { start: '<', end: '>' },
    { start: '＜', end: '＞' }
];

/**
 * デリミタで囲まれたテキストを選択してコピー（デリミタは除外）
 * - カーソル位置から左に開始デリミタを検索
 * - 対応する終了デリミタを右に検索
 * - 見つからない場合は行全体をコピー
 * - 1文字選択時はカーソル位置（選択方向）で動作を変更
 */
export async function copyTextBetweenDelimiters() {
    await processTextBetweenDelimiters(true); // 選択＋コピー
}

/**
 * デリミタで囲まれたテキストを選択するだけ（コピーしない）
 * - copyTextBetweenDelimiters と同じ検索ロジック
 * - 貼り付け先を選択してから Ctrl+V で置換する用途を想定
 */
export async function selectTextBetweenDelimiters() {
    await processTextBetweenDelimiters(false); // 選択のみ
}

/**
 * デリミタ間テキストの共通処理
 * @param copyToClipboard true=選択＋コピー、false=選択のみ
 */
async function processTextBetweenDelimiters(copyToClipboard: boolean) {
    const editor = vscode.window.activeTextEditor;
    if (!editor) {
        vscode.window.showWarningMessage('アクティブなエディタがありません');
        return;
    }

    const document = editor.document;
    const selection = editor.selection;
    const cursorPos = selection.active;
    const line = document.lineAt(cursorPos.line);
    const lineText = line.text;

    // 1文字選択時の特殊処理（選択方向で動作を変更）
    if (!selection.isEmpty && selection.end.character - selection.start.character === 1) {
        const selectedChar = lineText[selection.start.character];
        const charPos = selection.start.character;

        // カーソルが選択文字の右側（左→右選択）
        if (selection.active.character > selection.anchor.character) {
            const result = handleRightDirection(lineText, charPos, selectedChar);
            if (result) {
                await applyResult(editor, cursorPos.line, result.start, result.end, copyToClipboard);
                return;
            }
        }
        // カーソルが選択文字の左側（右→左選択）
        else if (selection.active.character < selection.anchor.character) {
            const result = handleLeftDirection(lineText, charPos, selectedChar);
            if (result) {
                await applyResult(editor, cursorPos.line, result.start, result.end, copyToClipboard);
                return;
            }
        }
    }

    // 通常処理：カーソル位置から左に開始デリミタを検索
    const result = findDelimitedText(lineText, cursorPos.character);

    if (result) {
        await applyResult(editor, cursorPos.line, result.start, result.end, copyToClipboard);
    } else {
        // 見つからない場合は行全体を対象
        if (copyToClipboard) {
            copyEntireLine(editor, cursorPos.line);
        } else {
            selectEntireLine(editor, cursorPos.line);
        }
    }
}

/**
 * 右方向処理：選択文字が開始デリミタかチェックし、右に終了デリミタを検索（ネスト考慮）
 */
function handleRightDirection(
    lineText: string,
    charPos: number,
    selectedChar: string
): { start: number; end: number } | null {
    for (const pair of DELIMITER_PAIRS) {
        if (selectedChar === pair.start) {
            // ネストレベルを考慮して対応する終了デリミタを検索
            const endPos = findMatchingEndDelimiter(lineText, charPos, pair.start, pair.end);
            if (endPos !== -1) {
                // デリミタを除外: 開始の次の文字から終了の前まで
                return { start: charPos + 1, end: endPos };
            }
        }
    }
    return null;
}

/**
 * 左方向処理：選択文字が終了デリミタかチェックし、左に開始デリミタを検索（ネスト考慮）
 */
function handleLeftDirection(
    lineText: string,
    charPos: number,
    selectedChar: string
): { start: number; end: number } | null {
    for (const pair of DELIMITER_PAIRS) {
        if (selectedChar === pair.end) {
            // ネストレベルを考慮して対応する開始デリミタを検索
            const startPos = findMatchingStartDelimiter(lineText, charPos, pair.start, pair.end);
            if (startPos !== -1) {
                // デリミタを除外: 開始の次の文字から終了の前まで
                return { start: startPos + 1, end: charPos };
            }
        }
    }
    return null;
}

/**
 * カーソル位置からデリミタで囲まれたテキストを検索（デリミタは除外）
 * - 左に開始デリミタを検索
 * - ネストレベルを考慮して対応する終了デリミタを右に検索
 */
function findDelimitedText(
    lineText: string,
    cursorPos: number
): { start: number; end: number } | null {
    let bestMatch: { start: number; end: number; startPos: number } | null = null;

    // 各デリミタペアについて検索
    for (const pair of DELIMITER_PAIRS) {
        // カーソル位置の左側で最後に出現する開始デリミタを検索
        let startPos = -1;
        for (let i = cursorPos - 1; i >= 0; i--) {
            if (lineText[i] === pair.start) {
                startPos = i;
                break;
            }
        }

        if (startPos === -1) {
            continue; // 開始デリミタが見つからない
        }

        // 対応する終了デリミタを検索（ネストレベルを考慮）
        const endPos = findMatchingEndDelimiter(lineText, startPos, pair.start, pair.end);

        if (endPos !== -1) {
            // カーソル位置が範囲内にあるかチェック
            if (startPos < cursorPos && cursorPos <= endPos) {
                // より近い開始デリミタを優先
                if (!bestMatch || startPos > bestMatch.startPos) {
                    // デリミタを除外: 開始の次の文字から終了の前まで
                    bestMatch = {
                        start: startPos + 1,
                        end: endPos,
                        startPos: startPos
                    };
                }
            }
        }
    }

    if (bestMatch) {
        return { start: bestMatch.start, end: bestMatch.end };
    }

    return null;
}

/**
 * ネストレベルを考慮して対応する終了デリミタを検索
 */
function findMatchingEndDelimiter(
    lineText: string,
    startPos: number,
    startDelimiter: string,
    endDelimiter: string
): number {
    // 開始と終了が同じ文字の場合（" や ' など）は従来の方式
    if (startDelimiter === endDelimiter) {
        return lineText.indexOf(endDelimiter, startPos + 1);
    }

    // 異なる文字の場合はネストレベルを考慮
    let nestLevel = 1; // 開始デリミタを見つけた状態から開始

    for (let i = startPos + 1; i < lineText.length; i++) {
        const char = lineText[i];

        if (char === startDelimiter) {
            nestLevel++; // 同じ開始デリミタが出現したらネストレベル+1
        } else if (char === endDelimiter) {
            nestLevel--; // 終了デリミタが出現したらネストレベル-1

            if (nestLevel === 0) {
                return i; // ネストレベルが0になったら対応する終了デリミタを発見
            }
        }
    }

    return -1; // 対応する終了デリミタが見つからない
}

/**
 * ネストレベルを考慮して対応する開始デリミタを検索（逆方向）
 */
function findMatchingStartDelimiter(
    lineText: string,
    endPos: number,
    startDelimiter: string,
    endDelimiter: string
): number {
    // 開始と終了が同じ文字の場合（" や ' など）は従来の方式
    if (startDelimiter === endDelimiter) {
        return lineText.lastIndexOf(startDelimiter, endPos - 1);
    }

    // 異なる文字の場合はネストレベルを考慮（逆方向）
    let nestLevel = 1; // 終了デリミタを見つけた状態から開始

    for (let i = endPos - 1; i >= 0; i--) {
        const char = lineText[i];

        if (char === endDelimiter) {
            nestLevel++; // 同じ終了デリミタが出現したらネストレベル+1
        } else if (char === startDelimiter) {
            nestLevel--; // 開始デリミタが出現したらネストレベル-1

            if (nestLevel === 0) {
                return i; // ネストレベルが0になったら対応する開始デリミタを発見
            }
        }
    }

    return -1; // 対応する開始デリミタが見つからない
}

/**
 * 指定範囲を選択し、copyToClipboard=true の場合はコピーも行う
 */
async function applyResult(
    editor: vscode.TextEditor,
    line: number,
    startChar: number,
    endChar: number,
    copyToClipboard: boolean
) {
    const startPos = new vscode.Position(line, startChar);
    const endPos = new vscode.Position(line, endChar);
    editor.selection = new vscode.Selection(startPos, endPos);
    if (copyToClipboard) {
        await vscode.commands.executeCommand('editor.action.clipboardCopyAction');
    }
}

/**
 * 行全体をクリップボードにコピー
 */
async function copyEntireLine(editor: vscode.TextEditor, lineNumber: number) {
    const line = editor.document.lineAt(lineNumber);
    editor.selection = new vscode.Selection(line.range.start, line.range.end);
    await vscode.commands.executeCommand('editor.action.clipboardCopyAction');
    vscode.window.showInformationMessage('デリミタが見つからないため、行全体をコピーしました');
}

/**
 * 行全体を選択するだけ（コピーしない）
 */
function selectEntireLine(editor: vscode.TextEditor, lineNumber: number) {
    const line = editor.document.lineAt(lineNumber);
    editor.selection = new vscode.Selection(line.range.start, line.range.end);
    vscode.window.showInformationMessage('デリミタが見つからないため、行全体を選択しました');
}

コードのポイント解説

1. デリミタペアの定義

const DELIMITER_PAIRS: Array<{ start: string; end: string }> = [
    { start: '"', end: '"' },
    { start: "'", end: "'" },
    { start: '`', end: '`' }, // バッククォート（テンプレートリテラル・Markdownインラインコード）
    { start: '「', end: '」' },
    // ... 18種類
];

開始文字と終了文字のペアを配列で管理。拡張が容易な設計です。

2. コピーと選択の共通化

// コピーする場合（Ctrl+Alt+D）
export async function copyTextBetweenDelimiters() {
    await processTextBetweenDelimiters(true);
}

// 選択のみの場合（Ctrl+Alt+S）
export async function selectTextBetweenDelimiters() {
    await processTextBetweenDelimiters(false);
}

// 共通処理（copyToClipboard で動作を分岐）
async function processTextBetweenDelimiters(copyToClipboard: boolean) {
    // ...
    await applyResult(editor, line, start, end, copyToClipboard);
}

copyToClipboardフラグ1つで2つのコマンドを共通化。検索ロジックの重複をなくし、保守性を高めています。

3. 選択方向の判定

// カーソルが選択文字の右側（左→右選択）
if (selection.active.character > selection.anchor.character) {
    // 右方向処理
}
// カーソルが選択文字の左側（右→左選択）
else if (selection.active.character < selection.anchor.character) {
    // 左方向処理
}

VSCodeのselection.active（カーソル位置）とselection.anchor（選択開始位置）を比較して選択方向を判定。

4. 最も近いデリミタの優先

// より近い開始デリミタを優先
if (!bestMatch || startPos > bestMatch.startPos) {
    bestMatch = {
        start: startPos + 1,
        end: endPos,
        startPos: startPos
    };
}

複数のデリミタペアが見つかった場合、カーソルに最も近い開始デリミタを優先します。

5. デリミタの除外

// デリミタを除外: 開始の次の文字から終了の前まで
return { start: charPos + 1, end: endPos };

開始デリミタの次の文字から終了デリミタの前までを選択範囲とすることで、デリミタ自体を除外します。

6. パフォーマンス最適化

// 行内のみの線形検索
for (let i = cursorPos - 1; i >= 0; i--) {
    if (lineText[i] === pair.start) {
        startPos = i;
        break;
    }
}

行内のみを検索対象とすることで、長大なファイルでもパフォーマンスに影響しません。

7. ネストレベル考慮のアルゴリズム

function findMatchingEndDelimiter(lineText: string, startPos: number, startDelimiter: string, endDelimiter: string): number {
    // 開始と終了が同じ文字（" や ' など）は従来の方式
    if (startDelimiter === endDelimiter) {
        return lineText.indexOf(endDelimiter, startPos + 1);
    }

    // 異なる文字の場合はネストレベルを考慮
    let nestLevel = 1; // 開始デリミタを見つけた状態から開始

    for (let i = startPos + 1; i < lineText.length; i++) {
        const char = lineText[i];

        if (char === startDelimiter) {
            nestLevel++; // 同じ開始デリミタが出現 → ネスト +1
        } else if (char === endDelimiter) {
            nestLevel--; // 終了デリミタが出現 → ネスト -1

            if (nestLevel === 0) {
                return i; // ネストレベルが0 → 対応する括弧を発見
            }
        }
    }

    return -1; // 対応する終了デリミタが見つからない
}

ポイント：

• nestLevel = 1 から開始（開始デリミタを見つけた状態）
• 同じ開始デリミタが出現するたびに nestLevel++（ネストが深くなる）
• 終了デリミタが出現するたびに nestLevel--（ネストから抜ける）
• nestLevel === 0 になった位置が対応する終了デリミタ

具体例：

function(a, (b, c), d)
        ↑開始

1. function( → nestLevel = 1
2. (b → nestLevel = 2（ネストが深くなる）
3. c) → nestLevel = 1（ネストから抜ける）
4. d) → nestLevel = 0 ✅ ここが対応する閉じ括弧

これにより、複雑な入れ子構造でも正確にペアを検出できます。

package.jsonの設定

拡張機能のコマンドとキーバインディングを登録します。

{
  "contributes": {
    "commands": [
      {
        "command": "myMacros.copyTextBetweenDelimiters",
        "title": "Copy Text Between Delimiters",
        "category": "My Macros"
      },
      {
        "command": "myMacros.selectTextBetweenDelimiters",
        "title": "Select Text Between Delimiters",
        "category": "My Macros"
      }
    ],
    "keybindings": [
      {
        "command": "myMacros.copyTextBetweenDelimiters",
        "key": "ctrl+alt+d",
        "when": "editorTextFocus"
      },
      {
        "command": "myMacros.selectTextBetweenDelimiters",
        "key": "ctrl+alt+s",
        "when": "editorTextFocus"
      }
    ]
  }
}

extension.tsでの登録

import { copyTextBetweenDelimiters, selectTextBetweenDelimiters } from './macros/copyTextBetweenDelimiters';

export function activate(context: vscode.ExtensionContext) {
    const commands = [
        vscode.commands.registerCommand(
            'myMacros.copyTextBetweenDelimiters',
            copyTextBetweenDelimiters
        ),
        vscode.commands.registerCommand(
            'myMacros.selectTextBetweenDelimiters',
            selectTextBetweenDelimiters
        ),
        // ... 他のコマンド
    ];

    commands.forEach(command => context.subscriptions.push(command));
}

使い方

基本的な使い方

ステップ1：カーソルを配置

デリミタで囲まれたテキスト内にカーソルを配置します。

const message = "ここにカーソル";
                 ↑

ステップ2：マクロ実行

• Ctrl+Alt+D → 選択してクリップボードにコピー
• Ctrl+Alt+S → 選択のみ（クリップボードは変更しない）

ステップ3：完了

デリミタ内のテキストが選択（または選択＋コピー）されます。

コピー&貼り付け置換の使い方

Ctrl+Alt+DとCtrl+Alt+Sを組み合わせると、クリップボードを保持したまま置換できます。

const src = "コピー元のテキスト";
const dst = "ここに上書きしたい";

1. "コピー元のテキスト" 内にカーソル → Ctrl+Alt+D でコピー
2. "ここに上書きしたい" 内にカーソルを移動
3. Ctrl+Alt+S で選択（クリップボードは変わらない）
4. Ctrl+V で貼り付け → 置換完了！

方向別の使い方

右方向検索

開始デリミタを1文字選択（左→右）してからCtrl+Alt+D

＜"あいうえお"＞
   ↑選択 ↑カーソル

→ 右に"を検索してあいうえおを選択

左方向検索

終了デリミタを1文字選択（右→左）してからCtrl+Alt+D

＜"あいうえお"＞
   ↑カーソル ↑選択

→ 左に"を検索してあいうえおを選択

トラブルシューティング

Q: デリミタが認識されない

A: 対応デリミタを確認してください

現在対応しているのは18種類のデリミタです。バッククォート（`）も対応済みです。対応していないデリミタはDELIMITER_PAIRS配列に追加すれば簡単に拡張できます。

Q: 入れ子構造で意図しない範囲が選択される

A: ネストレベルを考慮して正確にマッチングします

改修後のバージョンでは、括弧のネストレベルを考慮して対応する括弧を検出します。

function(a, (b, c), d)
        ↑ここにカーソル

この場合：

• カーソルの左で最も近い(（functionの後）を検出
• ネストレベルをカウントしながら対応する)を検索
• 内側の(b, c)のネストを考慮して、最外側の)を正確に検出

ただし、異なる種類のデリミタの場合は最も近いものが優先されます：

＜"「あいうえお」、【かきくけこ】"＞
     ↑ここにカーソル

この場合、「～」が選択されます（最も近いため）。外側の"～"を選択したい場合は、"と「の間にカーソルを配置してください。

Q: 行全体がコピーされてしまう

A: デリミタが見つからない場合のフォールバック動作です

• カーソル位置の左に開始デリミタがない
• 対応する終了デリミタが右に見つからない
• カーソル位置がデリミタの外側

これらの場合、安全のため行全体をコピーします。

Q: 動作が遅い

A: 行内のみの検索なのでパフォーマンス問題はありません

1行あたりの検索は線形時間（O(n)）で、通常の行（数百文字）なら瞬時に完了します。

パフォーマンスについて

計算量

• 時間計算量: O(n × m)

  • n: 行の文字数
  • m: デリミタペアの数（18個）
  • 通常の行（100文字）なら約1800回の比較

• 空間計算量: O(1)

  • 固定サイズのデータ構造のみ使用

ベンチマーク（参考値）

• 100文字の行: < 1ms
• 1000文字の行: < 5ms
• 10000文字の行: < 50ms

実用上、全く問題ないレベルです。

拡張アイデア

カスタムデリミタの設定

VSCodeの設定ファイル（settings.json）から読み込むようにすれば、ユーザー独自のデリミタにも対応可能です。

{
  "myMacros.customDelimiters": [
    { "start": "/*", "end": "*/" },
    { "start": "<!--", "end": "-->" }
  ]
}

複数行対応

現在は行内のみですが、開始・終了デリミタが別の行にある場合も対応できます（ただし、パフォーマンスへの配慮が必要）。

まとめ：キーボード1回でデリミタ内を抜き出す快適さ

VSCodeの標準機能では手が届かなかった「デリミタ間のテキスト選択」を、TypeScriptマクロで実現しました。

このマクロの強み：

• 1キー操作で完結（Ctrl+Alt+D コピー / Ctrl+Alt+S 選択のみ）
• 18種類のデリミタに対応（バッククォートも含む）
• 選択方向で動作を切り替え可能
• 入れ子構造でも正確に動作（ネストレベル考慮）
• パフォーマンス問題なし
• デリミタが見つからない場合も安全（行全体をフォールバック）

こんな人におすすめ：

• コードレビューでログやJSONを頻繁に扱う
• 文字列リテラルのコピペが多い
• マウス操作を減らしたい
• キーボードだけで完結させたい

標準のVSCodeでは「Ctrl+Shift+→」を何度も押す必要があった操作が、たった1回のキー操作で完了します。

「需要はないかもしれない」と思っていましたが、一度使うと手放せない便利機能です。特に大量のテキストを扱う作業では、作業効率が劇的に向上します。

ぜひVSCodeでの快適なテキスト編集にお役立てください！

関連記事

• VSCodeで「任意行までの一括選択・コピー」を実現するTypeScriptマクロ

VSCodeで「任意行までの一括選択・コピー」を実現するTypeScriptマクロ開発【サクラエディタ移行の集大成】

はじめに：テキスト編集における「範囲選択の不便さ」VSCodeで長いログファイルやドキュメントを編集していて、「この行から特定の文字列まで一気にコピーしたい」と思ったことはありませんか？通常のVSCodeでは、以下のような手順が必要です：開...

caymezon.com

2026.02.08

• VSCodeで「選択行による一括置換」を実現するTypeScriptマクロ

VSCodeで「選択行による一括置換」を実現するTypeScriptマクロ【テキスト編集が10倍速くなる】

はじめにテキスト編集で「複数の文字列を一度に置換したい」と思ったことはありませんか？例えば、こんなシーン：変数名を複数箇所で一括変更テーブル定義のデータ型を複数列で一括更新ドキュメント内の用語統一を複数ワードで一括実施VSCodeの標準機能...

caymezon.com

2026.02.08

• VSCodeで正規表現マッチを一括抽出するTypeScriptマクロ

VSCodeで「正規表現マッチ抽出」を実現するTypeScriptマクロ【ログ解析が10倍速くなる】

はじめにサーバーログやアプリケーションログを解析する時、こんな悩みありませんか？2024-02-08 10:00:00 INFO: Server started2024-02-08 10:01:00 ERROR: Connection fa...

caymezon.com

2026.02.08

• VSCodeでパスを読み取り専用で開くTypeScriptマクロ

VSCodeでカーソル下のパスを開くマクロ【Office読み取り専用・関連付けアプリ・連続起動対応】

はじめにVSCodeでコードやドキュメントを書いている時、テキスト内にパスが書かれていてそのファイルを開きたいこと、ありませんか？作業メモ.txt---設計書: C:\work\documents\設計書_v1.0.docx手順書: C:\...

caymezon.com

2026.02.06

タグ: #VSCode #TypeScript #マクロ #テキスト編集 #生産性向上 #エディタ

The post VSCodeで「デリミタ間テキスト選択コピー」を実現するTypeScriptマクロ【括弧・引用符を1キーで抜き出し】 first appeared on CayTech Lab.

はじめに

プロジェクト管理や作業記録で、こんな悩みありませんか？

作業メモ.txt
---
■ タスク
プロジェクトフォルダのファイル構成をドキュメント化
→ C:\work\my-project のファイル一覧を取得したい

■ 課題
共有フォルダの棚卸し
→ \\server\share\old-projects のファイル数とサイズを確認したい

「フォルダ配下のファイル一覧が欲しい」
「サイズや更新日時も記録したい」
「再帰的に全サブフォルダも取得したい」

Windowsのエクスプローラーでは、ファイル一覧をテキストでコピーできません。コマンドプロンプトでdirコマンド…も面倒。

今回、カーソル行のフォルダパスから一覧を取得し、別ファイルに出力するTypeScriptマクロを実装しました。

シンプル版と詳細版の2モードで、実務でのファイル管理が劇的に効率化します。

なぜこのツールが必要なのか？

Windowsの標準機能では実現困難

エクスプローラーの限界：

• ファイル一覧をテキストでコピーできない
• ドラッグ＆ドロップは画像のみ
• パスのリストは手動でコピペが必要

コマンドプロンプトの課題：

dir /s /b C:\work\my-project > list.txt

• パス指定が面倒
• オプションを毎回調べる必要
• 出力フォーマットの調整が困難

PowerShellでも：

Get-ChildItem -Recurse | Out-File list.txt

• コマンドが長い
• カスタマイズが複雑
• 毎回コマンドを打つのが手間

このマクロで実現できること

実装した機能

主な機能

ショートカット:

• Ctrl+F11: シンプル版（パスのみ）
• Ctrl+Shift+F11: 詳細版（サイズ・日時付き）

✅ 2つの出力モード

• シンプル版：パスのみをリスト化
• 詳細版：ファイルサイズ＋更新日時付き

✅ 4つの取得モード（ダイアログで選択）

1. 直下のみ（フォルダ + ファイル）← 最も安全
2. 直下のみ（ファイルのみ）
3. 再帰的（フォルダ + ファイル）← 警告付き
4. 再帰的（ファイルのみ）← 警告付き

✅ 充実の安全装置

• 再帰検索時の確認ダイアログ
• ネットワークドライブ検出＆警告
• タイムアウト：60秒
• 最大件数：50,000件（超過時は切り詰め）
• プログレス表示＋キャンセル可能
• node_modules, .git, dist等を自動除外

✅ 柔軟なパス指定

• ファイルパス → 親フォルダを対象
• フォルダパス → そのフォルダを対象
• 絶対パス、相対パス、ネットワークパス対応

出力例

シンプル版（Ctrl+F11）

============================================================
フォルダ一覧取得結果
============================================================
実行日時: 2024-02-08 15:30:45
対象フォルダ: C:\work\my-project
モード: 直下のみ（フォルダ + ファイル）
取得件数: 25 件
============================================================

C:\work\my-project\src
C:\work\my-project\test
C:\work\my-project\package.json
C:\work\my-project\README.md
C:\work\my-project\tsconfig.json
...

詳細版（Ctrl+Shift+F11）

============================================================
フォルダ一覧取得結果
============================================================
実行日時: 2024-02-08 15:30:45
対象フォルダ: C:\work\my-project
モード: 再帰的（ファイルのみ）
取得件数: 234 件
============================================================

[DIR ] C:\work\my-project\src
[FILE] C:\work\my-project\src\main.ts          (12.5 KB) 2024-02-01
[FILE] C:\work\my-project\src\util.ts          (8.2 KB)  2024-02-05
[DIR ] C:\work\my-project\test
[FILE] C:\work\my-project\test\test.ts         (4.1 KB)  2024-02-03
[FILE] C:\work\my-project\package.json         (1.2 KB)  2024-01-30
...

実務での活用例

例1：プロジェクトのファイル構成をドキュメント化

シーン：READMEにファイル構成を記載

README.md作成タスク
---
プロジェクト: C:\work\api-server

手順：

1. カーソルをパスの行に置く
2. Ctrl+F11 → 直下のみ（全て）
3. 結果をREADMEにコピペ

成果：

## ファイル構成
src/
  main.ts       - エントリーポイント
  routes/       - APIルート定義
  models/       - データモデル
test/           - テストコード
package.json    - 依存関係

例2：共有フォルダの棚卸し

シーン：不要ファイルの洗い出し

棚卸しタスク
---
対象: \\server\share\old-projects

手順：

1. Ctrl+Shift+F11 → 再帰的（ファイルのみ）
2. 警告確認 → 続行
3. サイズと日時で古いファイルを特定

成果：

[FILE] \\server\share\old-projects\backup_2020.zip  (500 MB) 2020-01-15
[FILE] \\server\share\old-projects\temp.dat         (1.2 GB) 2019-08-22
→ 不要ファイルを削除して1.7GB削減

例3：納品物のファイルリスト作成

シーン：納品前のファイルリスト作成

納品準備
---
成果物フォルダ: C:\delivery\client-system-v1.0

手順：

1. Ctrl+F11 → 再帰的（全て）
2. ファイルリストを納品書に添付

成果：

【納品物一覧】
src/           - ソースコード（50ファイル）
docs/          - 設計書・マニュアル（12ファイル）
installer/     - インストーラー（3ファイル）
合計：65ファイル

例4：バックアップ前の記録

シーン：バックアップ前のスナップショット

バックアップ計画
---
対象: C:\important-data

手順：

1. Ctrl+Shift+F11 → 再帰的（詳細版）
2. ファイル一覧をバックアップと一緒に保存

成果：

• バックアップ時のファイル構成を記録
• 復旧時に何があったか確認可能
• サイズと日時で変更箇所を追跡

例5：プロジェクトの進捗報告

シーン：週次報告でのファイル数増加報告

先週: 150ファイル
今週: 234ファイル
→ 84ファイル増加（機能追加により）

手順：

1. 毎週同じフォルダでCtrl+F11実行
2. ファイル数の推移を記録
3. 報告書に添付

TypeScriptコード解説

メイン処理（listFolderContents.ts）

import * as vscode from 'vscode';
import * as path from 'path';
import * as fs from 'fs';

/**
 * 出力モード
 */
enum OutputMode {
    Simple,   // シンプル（パスのみ）
    Detailed  // 詳細（サイズ・日時付き）
}

/**
 * 一覧取得オプション
 */
interface ListOptions {
    recursive: boolean;    // 再帰的に取得するか
    filesOnly: boolean;    // ファイルのみか
}

/**
 * フォルダ一覧取得（シンプル版）
 */
export async function listFolderContentsSimple() {
    await listFolderContents(OutputMode.Simple);
}

/**
 * フォルダ一覧取得（詳細版）
 */
export async function listFolderContentsDetailed() {
    await listFolderContents(OutputMode.Detailed);
}

/**
 * メイン処理
 */
async function listFolderContents(mode: OutputMode) {
    const editor = vscode.window.activeTextEditor;
    if (!editor) {
        vscode.window.showWarningMessage('アクティブなエディタがありません');
        return;
    }

    // カーソル行からパスを取得
    const line = editor.document.lineAt(editor.selection.active.line);
    let targetPath = line.text.trim();

    // パス前処理
    targetPath = preprocessPath(targetPath);
    targetPath = resolveAbsolutePath(targetPath, editor.document.uri.fsPath);

    // 存在チェック
    if (!fs.existsSync(targetPath)) {
        vscode.window.showErrorMessage(`パスが見つかりません: ${targetPath}`);
        return;
    }

    // フォルダパスに変換（ファイルの場合は親フォルダ）
    const folderPath = getFolderPath(targetPath);

    // オプション選択
    const options = await showOptionsDialog();
    if (!options) return;

    // 再帰的検索の場合は警告
    if (options.recursive) {
        const confirmed = await showWarningDialog(folderPath);
        if (!confirmed) return;
    }

    // 実行
    await executeWithProgress(folderPath, options, mode);
}

オプション選択ダイアログ

/**
 * オプション選択ダイアログ
 */
async function showOptionsDialog(): Promise<ListOptions | null> {
    const items = [
        {
            label: '$(file-directory) 直下のみ（フォルダ + ファイル）',
            description: '最も安全。1階層のみ取得',
            recursive: false,
            filesOnly: false
        },
        {
            label: '$(file) 直下のみ（ファイルのみ）',
            description: '最も安全。1階層のファイルのみ',
            recursive: false,
            filesOnly: true
        },
        {
            label: '$(repo) 再帰的（フォルダ + ファイル）',
            description: '⚠️ 時間がかかる可能性あり',
            recursive: true,
            filesOnly: false
        },
        {
            label: '$(files) 再帰的（ファイルのみ）',
            description: '⚠️ 時間がかかる可能性あり',
            recursive: true,
            filesOnly: true
        }
    ];

    const selected = await vscode.window.showQuickPick(items, {
        placeHolder: '一覧取得のモードを選択してください',
        ignoreFocusOut: true
    });

    if (!selected) return null;

    return {
        recursive: selected.recursive,
        filesOnly: selected.filesOnly
    };
}

警告ダイアログ（再帰検索時）

/**
 * 警告ダイアログ
 */
async function showWarningDialog(folderPath: string): Promise<boolean> {
    let warningMessage = '⚠️ 再帰的検索を実行します。\n';

    // ネットワークドライブ警告
    if (isNetworkPath(folderPath)) {
        warningMessage += '\n⚠️ ネットワークドライブが検出されました。\n' +
                         '処理に非常に時間がかかる可能性があります。\n';
    }

    warningMessage += '\n続行しますか？';

    const answer = await vscode.window.showWarningMessage(
        warningMessage,
        { modal: true },
        '続行', 'キャンセル'
    );

    return answer === '続行';
}

/**
 * ネットワークパスかどうか判定
 */
function isNetworkPath(p: string): boolean {
    return p.startsWith('\\\\') || p.startsWith('//');
}

プログレス表示とタイムアウト

/**
 * プログレス表示付きで実行
 */
async function executeWithProgress(
    folderPath: string,
    options: ListOptions,
    mode: OutputMode
) {
    await vscode.window.withProgress({
        location: vscode.ProgressLocation.Notification,
        title: "フォルダ一覧を取得中...",
        cancellable: true
    }, async (progress, token) => {
        try {
            let isCancelled = false;

            // キャンセルトークン
            token.onCancellationRequested(() => {
                isCancelled = true;
            });

            // タイムアウトPromise（60秒）
            const timeoutPromise = new Promise<never>((_, reject) => {
                setTimeout(() => reject(new Error('タイムアウト（60秒）')), 60000);
            });

            // ファイル一覧取得Promise
            const listPromise = listFiles(folderPath, options, mode, (count) => {
                progress.report({
                    message: `${count}件取得済み...`,
                    increment: 1
                });
                return isCancelled;
            });

            // タイムアウトとレース
            const result = await Promise.race([listPromise, timeoutPromise]);

            if (isCancelled) {
                vscode.window.showInformationMessage('処理をキャンセルしました');
                return;
            }

            // 結果を出力
            await createResultFile(folderPath, options, result.files, result.truncated, mode);

            let message = `取得完了: ${result.files.length}件`;
            if (result.truncated) {
                message += '（上限50,000件に達したため切り詰め）';
            }
            vscode.window.showInformationMessage(message);

        } catch (error: any) {
            if (error.message.includes('タイムアウト')) {
                vscode.window.showErrorMessage('処理がタイムアウトしました（60秒）');
            } else {
                vscode.window.showErrorMessage(`エラー: ${error.message}`);
            }
        }
    });
}

再帰的ファイル取得

/**
 * 除外するフォルダ名
 */
const EXCLUDE_PATTERNS = [
    'node_modules',
    '.git',
    '.vscode',
    'target',
    'dist',
    'build',
    'out',
    'bin',
    '.idea'
];

/**
 * 最大件数
 */
const MAX_FILES = 50000;

/**
 * 再帰的にファイル一覧を取得
 */
async function listFilesRecursive(
    folderPath: string,
    files: FileInfo[],
    options: ListOptions,
    mode: OutputMode,
    onProgress: (count: number) => boolean
) {
    // キャンセルチェック
    if (onProgress(files.length)) return;

    // 最大件数チェック
    if (files.length >= MAX_FILES) return;

    try {
        const entries = fs.readdirSync(folderPath, { withFileTypes: true });

        for (const entry of entries) {
            const fullPath = path.join(folderPath, entry.name);

            if (entry.isDirectory()) {
                // 除外パターンチェック
                if (EXCLUDE_PATTERNS.includes(entry.name)) {
                    continue;
                }

                if (!options.filesOnly) {
                    files.push(createFileInfo(fullPath, true, mode));
                }

                // 再帰
                await listFilesRecursive(fullPath, files, options, mode, onProgress);
            } else {
                files.push(createFileInfo(fullPath, false, mode));
            }

            // 最大件数チェック
            if (files.length >= MAX_FILES) return;
        }
    } catch (error: any) {
        // アクセス権限エラーなどは無視
        console.error(`Error accessing ${folderPath}:`, error.message);
    }
}

出力フォーマット生成

/**
 * 出力内容を生成
 */
function generateOutput(
    folderPath: string,
    options: ListOptions,
    files: FileInfo[],
    truncated: boolean,
    mode: OutputMode
): string {
    const lines: string[] = [];

    // ヘッダー
    lines.push('='.repeat(60));
    lines.push('フォルダ一覧取得結果');
    lines.push('='.repeat(60));
    lines.push(`実行日時: ${formatDateTime(new Date())}`);
    lines.push(`対象フォルダ: ${folderPath}`);
    lines.push(`モード: ${getModeText(options)}`);
    lines.push(`取得件数: ${files.length.toLocaleString()} 件`);

    if (truncated) {
        lines.push('⚠️ 上限50,000件に達したため切り詰めました');
    }

    lines.push('='.repeat(60));
    lines.push('');

    // ファイル一覧
    if (mode === OutputMode.Simple) {
        // シンプル版：パスのみ
        files.forEach(file => {
            lines.push(file.path);
        });
    } else {
        // 詳細版：サイズ・日時付き
        files.forEach(file => {
            const type = file.isDirectory ? '[DIR ]' : '[FILE]';
            const sizeStr = file.size !== undefined ? formatSize(file.size) : '';
            const dateStr = file.modifiedDate ? formatDate(file.modifiedDate) : '';

            let line = `${type} ${file.path}`;
            if (sizeStr) line += `  (${sizeStr})`;
            if (dateStr) line += ` ${dateStr}`;

            lines.push(line);
        });
    }

    return lines.join('\n');
}

/**
 * ファイルサイズをフォーマット
 */
function formatSize(bytes: number): string {
    if (bytes < 1024) return `${bytes} B`;
    if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
    if (bytes < 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
    return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
}

使い方

1. 拡張機能のインストール

# GitHubからクローン
git clone https://github.com/xxxxx-sys/my-macros.git
cd my-macros

# 依存関係インストール
npm install --legacy-peer-deps

# パッケージ化
npm run compile
npx vsce package

# インストール
code --install-extension my-macros-0.0.6.vsix

2. 基本的な使い方

作業メモ.txt
---
プロジェクト: C:\work\my-project
共有フォルダ: \\server\share\documents

シンプル版（パスのみ）：

1. パスの行にカーソルを置く
2. Ctrl+F11
3. モード選択（直下のみ or 再帰的）
4. 結果が右側に表示
5. 保存ダイアログで保存

詳細版（サイズ・日時付き）：

1. パスの行にカーソルを置く
2. Ctrl+Shift+F11
3. モード選択（直下のみ or 再帰的）
4. 再帰の場合は警告確認
5. 結果が右側に表示
6. 保存ダイアログで保存

3. 実践例

シーン1: プロジェクトの構成確認

メモ.txt
---
C:\work\api-server

手順：

1. カーソルをパスに置く
2. Ctrl+F11 → 直下のみ（全て）
3. フォルダ構成を確認

シーン2: 大量ファイルの棚卸し

棚卸し.txt
---
\\server\share\old-projects

手順：

1. Ctrl+Shift+F11 → 再帰的（ファイルのみ）
2. 警告確認 → 続行
3. サイズと日時で古いファイルを特定

シーン3: 納品物リスト作成

納品準備.txt
---
C:\delivery\system-v1.0

手順：

1. Ctrl+F11 → 再帰的（全て）
2. ファイルリストを納品書に添付

package.jsonの設定

{
  "contributes": {
    "commands": [
      {
        "command": "myMacros.listFolderContentsSimple",
        "title": "List Folder Contents (Simple)",
        "category": "My Macros"
      },
      {
        "command": "myMacros.listFolderContentsDetailed",
        "title": "List Folder Contents (Detailed)",
        "category": "My Macros"
      }
    ],
    "keybindings": [
      {
        "command": "myMacros.listFolderContentsSimple",
        "key": "ctrl+f11",
        "when": "editorTextFocus"
      },
      {
        "command": "myMacros.listFolderContentsDetailed",
        "key": "ctrl+shift+f11",
        "when": "editorTextFocus"
      }
    ]
  }
}

メリット・デメリット

メリット

✅ 圧倒的な効率化

• 1キー操作でファイル一覧取得
• エクスプローラーでの手作業が不要
• コマンドを覚える必要なし

✅ 充実の安全装置

• タイムアウト（60秒）で暴走防止
• 最大50,000件で自動停止
• ネットワークドライブ警告
• キャンセル可能なプログレス表示

✅ 柔軟な出力モード

• シンプル版：パスのみ
• 詳細版：サイズ・日時付き
• 用途に応じて使い分け

✅ 自動除外機能

• node_modules, .git等を自動スキップ
• 不要なフォルダを除外して高速化

✅ 実行履歴の保存

• 実行日時を記録
• ファイル名に日時を自動付与
• 定期的な記録に最適

デメリット

❌ 巨大フォルダは時間がかかる

• 数万ファイルは数十秒待つ
• ネットワークドライブは特に遅い
• タイムアウト（60秒）で自動停止

❌ リアルタイム監視は非対応

• スナップショット取得のみ
• ファイル変更の自動検知なし

❌ アクセス権限エラー

• 権限のないフォルダはスキップ
• エラーは通知されない

トラブルシューティング

Q: パスが見つからない

A: パスの記述を確認

NG: プロジェクト: C:\work\project（余計な文字）
OK: C:\work\project

NG: "C:\work\project"（引用符付き）→ 自動除去されるが、余計な文字があると失敗

解決策: パスのみの行にする

Q: 処理が途中で止まる

A: タイムアウトまたは最大件数に達した

タイムアウト: 60秒経過で自動停止
最大件数: 50,000件で自動切り詰め

解決策:
- 直下のみで試す
- 対象フォルダを絞る
- 除外パターンを活用

Q: ネットワークドライブが遅い

A: 再帰検索を避ける

推奨: 直下のみで取得
非推奨: 再帰的（数分かかる可能性）

解決策:
- まず直下のみで確認
- サブフォルダを個別に処理

Q: node_modulesが除外される

A: 除外パターンを変更

// 除外したくない場合はコードを修正
const EXCLUDE_PATTERNS = [
    // 'node_modules', ← コメントアウト
    '.git',
    '.vscode'
];

Q: ファイルが保存できない

A: パスに書き込み権限があるか確認

NG: C:\Program Files\...（権限不足）
OK: C:\Users\[ユーザー名]\Documents\...

解決策: 書き込み可能なフォルダに保存

まとめ

VSCodeでカーソル行のフォルダパスから一覧を取得し、別ファイルに出力する機能を実装しました。

この機能が役立つ人：

• プロジェクトのファイル構成をドキュメント化したい
• 共有フォルダの棚卸しをしたい
• 納品物のファイルリストを作成したい
• バックアップ前の記録を残したい
• ファイル管理の効率を上げたい

特にエクスプローラーでは不可能なファイル一覧のテキスト化を1キーで実現できるため、実務での生産性向上に大きく貢献します。

プロジェクト管理、作業記録、納品準備、棚卸しなど、様々なシーンで活用できる実用的なツールです。

ぜひ試してみてください！

関連記事

サクラエディタからの移行経緯

サクラエディタからVSCodeへマクロ移行！快適開発環境の構築記録

はじめに長年愛用してきたサクラエディタのマクロ機能。便利なJavaScript/VBSマクロを多数作成して日常業務で活用してきましたが、最近のAWS開発やブログ執筆でVSCodeを使う機会が増えてきました。「VSCodeでもサクラエディタの...

caymezon.com

2026.01.25

TypeScriptマクロ開発環境の構築方法

VSCode TypeScriptマクロ開発環境の完全ガイド【セットアップから運用まで】

はじめにVSCodeでカスタムマクロを作成したいけど、どうやって開発環境を構築すればいいか分からない。そんな悩みを持つ方に向けて、TypeScriptでVSCode拡張機能を開発する環境の構築から、実際にマクロを作成して使えるようにするまで...

caymezon.com

2026.01.25

正規表現マッチ抽出ツール

VSCodeで「正規表現マッチ抽出」を実現するTypeScriptマクロ【ログ解析が10倍速くなる】

はじめにサーバーログやアプリケーションログを解析する時、こんな悩みありませんか？2024-02-08 10:00:00 INFO: Server started2024-02-08 10:01:00 ERROR: Connection fa...

caymezon.com

2026.02.08

タグ: #VSCode #TypeScript #マクロ #ファイル管理 #生産性向上 #フォルダ一覧

The post VSCodeで「フォルダ一覧取得」を実現するTypeScriptマクロ【ファイル管理が10倍速くなる】 first appeared on CayTech Lab.