これをよんで出来る事

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 "YourEmail@gmail.com"
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 を使うのなら、この拡張機能を入れると、リアルタイムで編集を見れるので楽
使うときは、右上の虫眼鏡マークを押す

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