環境構築【VSCode・WSL・GitHub・Latex・Google Colab連携】

これをよんで出来る事

• Github用のメモ・研究の執筆・コード管理・実験実行をVSCode上で出来るようになる
• WSL・Github・Latex・Google Colab にちょっと詳しくなる
• Windows 環境でも、Linux と同等の開発環境を構築出来る

個人的な意見

• ブラウザ上に大量にタブがあっても見失わない人には不要かも
• 昨日、作業を行ったので動かなくなる可能性はおおいにあるので注意
• このガイドは2025/12/03に作成しました

【参考資料】：

• WSL × VSCode による Windows 上での Linux 開発環境構築
  https://qiita.com/_masa_u/items/d3c1fa7898b0783bc3ed
• LaTeX 文書置き場として Git/GitHub を利用するチュートリアル
  https://qiita.com/Nmatician/items/765edfbd726725d1ae8c

全体の流れ

0. VSCode と Github , Git の基本設定(事前準備)

1. WSL2( Linux ) を導入

• 以下のコマンドをターミナルに打つ
  wsl --install
• パソコンを再起動する
  • Ubuntuが自動で入ってると思います
• 初回起動時にユーザIDとパスワードを設定
  • (出来ない場合には、sudo権限(管理者権限) を許可する。必要があるかも？)
• Linux内で、以下を入力する。( 次のコードから Linux )
  code .

2. WSL2( Linux側 )に Git を設定

• Git をインストールする
  sudo apt install git

• Git 初期設定( 自分の名前とメールアドレスを入れる )
  git config --global user.name "Your Name"
git config --global user.email "[e-mail]"

• GitHubでリポジトリをつくる( 緑の New )
  
  (Add .gitignore にチェックを入れて、Tex を選択すると楽です。)

• クローン用フォルダを準備
  mkdir git
cd git

• クローン実行( GitHub の URL をコピーして入れます )
  git clone https://github.com/<UserName>/<RepositoryName>

3. WSL2( Linux側 )に Latex を導入

• Tex Live( 完全版 )をインストール
  sudo apt install texlive-full
  ※時間がかかるので注意

• .latexmkrc の設定

  • プロジェクトのフォルダ直下に .latexmkrc を作成し、以下貼り付ける
  .latexmkrc

  # !/usr/bin/env perl
  
  # --- LaTeX 本体（Overleaf の $latex = 'uplatex'; を拡張したもの） ---
  $latex = 'uplatex -synctex=1 -halt-on-error -file-line-error %O %S';
  $max_repeat = 5;   # 必要に応じて複数回コンパイル
  
  # --- BibTeX（Overleaf の pbibtex） ---
  $bibtex = 'pbibtex %O %S';
  
  # --- 索引（Overleaf の mendex） ---
  $makeindex = 'mendex -U %O -o %D %S';
  
  # --- DVI → PDF（Overleaf の dvipdfmx） ---
  $dvipdf = 'dvipdfmx %O -o %D %S';
  
  # --- PDF モード（Overleaf と同じ 3: uplatex → DVI → dvipdfmx） ---
  $pdf_mode = 3;
  
  # --- Synctex ファイルをお掃除対象に追加（任意） ---
  $clean_full_ext = "%R.synctex.gz";
  
  # --- PDF ビューア設定（必要なら。Qiita 記事の例を踏襲） ---
  $pvc_view_file_via_temporary = 0;
  if ($^O eq 'linux') {
      $pdf_previewer = "xdg-open %S";
  } elsif ($^O eq 'darwin') {
      $pdf_previewer = "open %S";
  } else {
      $pdf_previewer = "start %S";
  }```
  
  

• VSCode の設定( setting.json )

• LaTex Workshop の挙動を整える為に、設定に以下を追記する：

  setting.json

  // ---------- 言語別のエディタ設定 ----------
  
    "[tex]": {
      // スニペット補完中にも通常の補完を出す
      "editor.suggest.snippetsPreventQuickSuggestions": false,
      // インデント幅
      "editor.tabSize": 2
    },
  
    "[latex]": {
      "editor.suggest.snippetsPreventQuickSuggestions": false,
      "editor.tabSize": 2
    },
  
    "[bibtex]": {
      "editor.tabSize": 2
    },
  
    // ---------- LaTeX Workshop の設定 ----------
  
    // 使用パッケージのコマンドや環境の補完を有効にする
    "latex-workshop.intellisense.package.enabled": true,
  
    // 生成ファイルを削除するときの対象（*.synctex.gz を追加）
    "latex-workshop.latex.clean.fileTypes": [
      "*.aux",
      "*.bbl",
      "*.blg",
      "*.idx",
      "*.ind",
      "*.lof",
      "*.lot",
      "*.out",
      "*.toc",
      "*.acn",
      "*.acr",
      "*.alg",
      "*.glg",
      "*.glo",
      "*.gls",
      "*.ist",
      "*.fls",
      "*.log",
      "*.fdb_latexmk",
      "*.snm",
      "*.nav",
      "*.dvi",
      "*.synctex.gz"
    ],
  
    // 中間ファイル・PDF を出力するディレクトリ
    "latex-workshop.latex.outDir": "PDF_out",
  
    // ビルドレシピ（＝どの tool を組み合わせて使うか）
    "latex-workshop.latex.recipes": [
      {
        "name": "latexmk (uplatex)",
        "tools": [
          "latexmk"
        ]
      }
    ],
  
    // 実際に呼び出すコマンド（tool）
    "latex-workshop.latex.tools": [
      {
        "name": "latexmk",
        "command": "latexmk",
        "args": [
          "-silent",          // ログを少し静かに
          "-outdir=%OUTDIR%", // 上で指定した outDir に出力
          "%DOC%"             // 現在の TeX ドキュメント
        ]
      }
    ],
  
    // PDF の表示方法（VSCode タブで表示）
    "latex-workshop.view.pdf.viewer": "tab"
  

• .gitignore の例

• プロジェクトのフォルダ直下に .gitignore を作成し、以下貼り付ける

• LaTex の中間ファイルを GitHub に上げないための設定

  .gitignore

   # LaTeX build files
   *.aux
   *.bbl
   *.blg
   *.dvi
   *.fls
   *.fdb_latexmk
   *.log
   *.synctex.gz
   *.toc
   *.out
   *.lof
   *.lot
   *.idx
   *.ilg
   *.ind
   *.nav
   *.snm
   
   # latexmk outDir
   out/*
   !out/*.pdf
  

4. VSCode から Google Colab に接続する設定

• VSCode の拡張機能から Colab をインストールする
• sample.ipynb を作成し、右上のカーネル部分で Colab のランタイムを選択出来る

5. その他（ 使い方とか )

• ファイルをワークスペースで開いておくと作業がしやすい

• Latex を使う際には、[* F1キー]を選択し、latexmkrc を使ってコンパイルする

• GitHub で Markdown を使うのなら、この拡張機能を入れると、リアルタイムで編集を見れるので楽
  

• 使うときは、右上の虫眼鏡マークを押す

追記：もっと良い方法とか間違ってるよ〜とかあったら気軽にコメントください🙇